Skip to main content

Get Order

GET https://api.paysera.com/merchant-order/integration/v1/orders/{id}

Retrieve a single order by its identifier. The order must belong to your project.

Authorization​

This endpoint requires an OAuth2 Bearer token. The project is taken from the token. See the Authentication guide.

Notes​

  • cancel_reason is null until the order is canceled. Known values are canceled_by_merchant, canceled_by_admin, project_deleted and expired_ttl; treat any other value as a generic cancellation.
  • Webhooks remain the recommended way to react to order changes. Use this endpoint for reconciliation or on-demand lookups.

See Payment Orders for order statuses and cancellation.

AUTHORIZATION: HTTP

REQUEST

Base URL
https://api.paysera.com

RESPONSE

Order retrieved successfully
{
  "id": "a6f2b8e3-5e5f-47d9-b13f-87ed2db2938a",
  "project_id": "b7c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
  "amount": 2500,
  "currency": "EUR",
  "status": "canceled",
  "reference": "ORDER-12345",
  "callback_url": "https://example.com/webhook",
  "success_url": "https://example.com/success",
  "fail_url": "https://example.com/failure",
  "cancel_url": "https://example.com/cancel",
  "source": "https://example.com",
  "created_at": 1736433000,
  "updated_at": 1736433600,
  "amount_paid": 0,
  "balance_due": 2500,
  "merchant_data": {
    "key1": "value1"
  },
  "split_config_id": null,
  "checkout_flow": null,
  "cancel_reason": "canceled_by_merchant",
  "payer_sets_amount": false,
  "minimum_amount": null,
  "maximum_amount": null,
  "suggested_amount": null,
  "amount_buttons": [],
  "payment_accepted_at": null
}