Skip to main content
POST
Fetch by Order ID
Retrieve an order using the Paytring order_id returned by Create Order. To look up your own receipt reference instead, use Fetch Order by Receipt ID. Authenticate with HTTP Basic Auth. Do not include key or hash in the request body.

Request example

Success response excerpt

Card details are returned only when available for a successful card payment. The response also contains customer, gateway, and other order details. The top-level status describes whether the fetch succeeded. order.order_status describes the payment state. Check both and match the receipt ID, amount, and currency against your records before marking a payment successful. V1 orders remain accessible through V2 for the same business account and test or live environment. Known API errors can return HTTP 200 with status: false; inspect the response body rather than relying on HTTP status alone.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
id
string
required

Paytring order_id returned by Create Order, not your receipt_id.

Required string length: 5 - 30
Example:

"1111111111111111"

Response

Inspect status. A successful fetch returns order; order.order_status is the payment state. Handled API errors can also return HTTP 200 with status false and error.

status
boolean
default:true
Example:

true

error
object

Present for a handled API error when status is false.

order
object