curl "https://sandbox.core.linkio.world/api/payments/pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE/details?decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payment retrieved",
"payment": {
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
}
{
"error": {
"type": "resource_not_found",
"code": "payment_not_found",
"message": "Payment pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE not found",
"request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
"status": 404
}
}
Payments
Get a payment
Get one payment by ID, including its current state.
GET
/
payments
/
{paymentId}
/
details
curl "https://sandbox.core.linkio.world/api/payments/pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE/details?decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payment retrieved",
"payment": {
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
}
{
"error": {
"type": "resource_not_found",
"code": "payment_not_found",
"message": "Payment pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE not found",
"request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
"status": 404
}
}
Requires the Ramps, banks & methods scope (payments read).
Headers
string
default:"2026-10-29-atlas"
required
Your account’s API version.
Path
string
required
The payment ID, starting with
pay_.Query
string
default:"false"
true to include the quote and customer details.Response
200 OK
string
successstring
Payment retrievedobject
Show fields
Show fields
string
Payment ID.
string | null
The customer.
string
The payment’s reference, starting with
ref_.string
The quote used.
object
Only with
decode=true. source_amount, source_currency, target_amount, target_currency, network, rate, payment_method, payout_method.object
Only with
decode=true. id, name, email.string
onramp or offramp.string
pending, success, or failed.string
The exact step. See onramp states and offramp states.
string | null
The blockchain transaction, once the stablecoin has moved.
string
When it was created.
string
When it last changed.
Errors
| Status | Code | Why |
|---|---|---|
404 | payment_not_found | No payment with this ID in your business. |
422 | validation_failed | The ID isn’t in the right format. |
curl "https://sandbox.core.linkio.world/api/payments/pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE/details?decode=true" \
-H "X-BRIDGE-API-Key: $BRIDGE_API_KEY" \
-H "API-Version: 2026-10-29-atlas"
{
"status": "success",
"message": "Payment retrieved",
"payment": {
"id": "pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE",
"customer_id": "cus_4hT9pL2mQx8VnR3tY7wZ1cB5dE",
"reference_id": "ref_7tY1wZ4cB6dE8fK2mQ9xLp3VnR",
"quote_id": "qte_9xLp3VnR7tY1wZ4cB6dE8fK2mQ",
"type": "onramp",
"status": "success",
"state": "completed",
"transaction_hash": "8c1f0e9a…",
"created_at": "2026-10-28T10:15:02.000Z",
"updated_at": "2026-10-28T10:21:17.000Z"
}
}
{
"error": {
"type": "resource_not_found",
"code": "payment_not_found",
"message": "Payment pay_8fK2mQ9xLp3VnR7tY1wZ4cB6dE not found",
"request_id": "req_3VnR7tY1wZ4cB6dE8fK2mQ9xLp",
"status": 404
}
}
Last modified on October 29, 2026
Was this page helpful?