Retrieve a payment
Returns the authenticated merchant's payment with status, amount totals, payment-method details, and transaction and refund history. Payments owned by another merchant are not returned.
Authorization
basic Basic HTTP authentication
In: header
Path Parameters
Payment id
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/payments/string"{ "id": "01928e1c-2a4d-7c8e-8b1a-1234567890ab", "object": "payment", "status": "CAPTURED", "currency": "usd", "amount": 2999, "paymentMethodType": "CARD", "paymentMethodDetails": { "brand": "visa", "bin": "411111", "last4": "1111", "expirationMonth": 12, "expirationYear": 2027 }, "transactions": [ { "id": "01928e1c-2a4d-7c8e-8b1a-1234567890ab", "object": "transaction", "type": "AUTH_AND_CAPTURE", "status": "SUCCEEDED", "amount": 2999, "parentTransactionId": "01928e1c-2a4d-7c8e-8b1a-1234567890ab", "declinedReason": "insufficient_funds", "reason": "requested_by_customer", "refundKind": "PARTIAL", "createdAt": "2026-06-23T12:00:00.000Z", "updatedAt": "2026-06-23T12:00:01.000Z" } ], "amounts": { "requested": 2999, "authorized": 2999, "captured": 2999, "voided": null, "refunded": 1000 }, "createdAt": "2026-06-23T12:00:00.000Z", "authorizedAt": "2026-06-23T12:00:00.000Z", "capturedAt": "2026-06-23T12:00:01.000Z", "voidedAt": null, "updatedAt": "2026-06-23T12:00:01.000Z"}{ "statusCode": 401, "error": "Unauthorized", "message": "Missing Authorization header"}{ "statusCode": 404, "error": "Not Found", "message": "Merchant not found: 01928e1c-2a4d-7c8e-8b1a-1234567890ab"}Create a checkout session POST
Creates a hosted checkout session for the total of the supplied line items and returns its URL. Payment-method saving is enabled by default and requires a customer email; set enablePaymentMethodSave to false to opt out.
Refund a captured payment POST
Refunds a successfully captured payment. Provide an amount for a partial refund, or omit it to refund the entire remaining refundable balance; cumulative refunds cannot exceed the captured amount.