Skip to main content
Version: Current guides

Use Checkout and payment links

Checkout is one payment session. Its creation response supplies the actual URL for that attempt. Public availability of the separate dashboard Payment Link tool—including no-code creation, payer-entered amounts, reusable links and QR downloads—is unconfirmed. Checkout access does not establish access to these tools.

Use an order Checkout​

  1. Follow create a payment request to save the order and attempt, then share the returned URL.
  2. Verify the goods or service description, amount and currency before sending. Tell the payer to use a network and method actually offered by Checkout.
  3. Retrieve the original Checkout when the customer returns. Resume an open session while valid; wait for processing; show the order outcome for succeeded; inspect the reason for failed.
  4. To stop collection, have an authorized technical owner close a Checkout that is still open, then query the result. Closing a browser, deleting a message or returning to the merchant does not close the session.
  5. If the entry has terminated, inspect submitted or late funds first. Create another session only when a new collection is needed and preserve both attempts.

The validity window includes confirmation time. Do not promise success merely because the payer clicked before expiry, a fixed number of minutes, or automatic return to your site.

Use these steps only for options actually provided in your account:

  1. Open link creation under payment tools and choose an identifying name and product or amount description.
  2. Decide whether a fixed or payer-entered amount fits the use case. If entry is allowed, set an acceptable range; do not use it for an order requiring an exact amount.
  3. Choose an available currency and network combination, then review offered options such as single-use or reusable access, expiry and return address.
  4. Preview the price, branding and explanation, and test both payment and expired-page behavior in the test environment.
  5. Copy the generated link. If a QR code is offered, scan it yourself to verify its destination and amount before sharing.
  6. Record the business activity behind the link and reconcile every resulting order. A reusable link is not a single order, and clicks are not successful payments.

Resolve common problems​

ProblemNext action
Expired, completed or closed linkInspect the original session and order; check submitted funds before requesting another payment
Wallet network mismatchSwitch to an actually supported combination; do not transfer blindly to the same address on another chain
Customer returns but the order still waitsQuery from the server; returning cannot change payment status
Reusable link must be disabledDisable only if the tool supports it, and inspect existing sessions separately; do not assume they are canceled
Link management is missingConfirm account availability and permissions; the technical team can use the confirmed Checkout path

Use payment exceptions for amount issues. Regenerating a QR code does not resolve funds already sent.