Skip to content
API referenceAPI v1admin-sdk 1.1.52Search docs⌘K
Payment links · Create a link
API reference / Payment links

Create a link

POST/api/v1/payment_linkspayment_links:write

A link the customer pays on Inkress's page at https://inkress.com/p/<uid>. Paying it creates an order and sends orders.paid.

Body

titlestringrequired

Shown on the payment page.

currency_codestringrequired

JMD or USD. Can't change later.

totalnumber

The amount, below 2,000,000. Can't change later.

descriptionstring

More detail on the payment page.

usage_limitinteger

How many payments the link is for. Kept with the link for your records.

expires_atstring

When it closes, ISO 8601. After that it can't be paid.

dataobject

Your own data. Put your reference in data.reference_id. data.available_from (ISO 8601 with an offset) keeps the link closed until then.

Headers

Authorizationheaderrequired

Bearer with your secret key, or the merchant's OAuth token.

Returns

The link, with its uid. status 1 means open.

Errors

401The key or token is missing, wrong or revoked, is for the other environment, or doesn't have the scope this endpoint needs.
422title or the currency is missing, the total is out of range, or data.available_from has no offset.