Use Checkout and payment links
Two link types and their availability
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
- Follow create a payment request to save the order and attempt, then share the returned URL.
- Verify the goods or service description, amount and currency before sending. Tell the payer to use a network and method actually offered by Checkout.
- Retrieve the original Checkout when the customer returns. Resume an
opensession while valid; wait forprocessing; show the order outcome forsucceeded; inspect the reason forfailed. - 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. - 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.
If dashboard payment links are enabled
Use these steps only for options actually provided in your account:
- Open link creation under payment tools and choose an identifying name and product or amount description.
- 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.
- Choose an available currency and network combination, then review offered options such as single-use or reusable access, expiry and return address.
- Preview the price, branding and explanation, and test both payment and expired-page behavior in the test environment.
- Copy the generated link. If a QR code is offered, scan it yourself to verify its destination and amount before sharing.
- 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
| Problem | Next action |
|---|---|
| Expired, completed or closed link | Inspect the original session and order; check submitted funds before requesting another payment |
| Wallet network mismatch | Switch to an actually supported combination; do not transfer blindly to the same address on another chain |
| Customer returns but the order still waits | Query from the server; returning cannot change payment status |
| Reusable link must be disabled | Disable only if the tool supports it, and inspect existing sessions separately; do not assume they are canceled |
| Link management is missing | Confirm 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.