Skip to main content
POST
/
v1
/
public
/
payment-links
/
{public_id}
/
checkout
curl --request POST \
  --url https://api.meum.io/v1/public/payment-links/{public_id}/checkout \
  --header 'Content-Type: application/json' \
  --data '
{
  "origin_asset": "usdc.near",
  "refund_to": "alice.near"
}
'
{
  "invoice_id": "<string>",
  "checkout_url": "<string>",
  "reused": true
}

Path Parameters

​
public_id
string
required

Public checkout token from the Pay Link's public_id field (starts with plpub_). Share this in checkout URLs; do not confuse with the merchant plink_ ID.

Pattern: ^plpub_[0-9a-z]{20,32}$
Example:

"plpub_c9a9bb730611077574c828af5af5fed1"

Body

application/json
​
origin_asset
string
required

Required. Which crypto the customer will pay with. Format: token.network: e.g. usdc.near means USDC on NEAR.

Example:

"usdc.near"

​
refund_to
string
required

Required. Wallet address to send refunds to if payment fails or the customer overpays. Must be valid on the same network as origin_asset (e.g. alice.near for NEAR).

Example:

"alice.near"

​
amount
string

How much to charge the customer, as a decimal string (e.g. "42.50"). Required when the Pay Link uses customer_defined_amount. Omit when the link has a fixed price; the link's amount is used automatically.

Example:

"42.50"

Response

Checkout session created

​
invoice_id
string
required

New or existing invoice for this checkout (inv_...). Use to track payment status.

Pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$
​
checkout_url
string<uri>
required

Open this URL in a browser to show the payment page to the customer.

​
reused
boolean
required

true: an unpaid invoice from a previous attempt was reused (common for single-use links). false: a brand-new invoice was created.