Skip to main content
Version: 1

Orders API

Orders are the top-level payment object in the Moyasar Payment Gateway. Every authorization, capture, void, refund, extension and verification performed by one of your merchants is attached to exactly one order and recorded as a Transaction under it.

As an acquirer you have read-only access to the orders of every merchant under your acquirer. Orders of other acquirers are never visible.

Amounts

All amounts are integers in the smallest currency unit (minor units). Derived running totals are exposed on every order:

FieldMeaning
amountOriginal authorized amount. Immutable.
captured_amountSum of approved capture transactions.
refunded_amountSum of approved refund transactions.
voided_amountSum of approved void transactions.

Required permission: orders_read.

Authentication

Acquirer API key sent as a bearer token:

Authorization: Bearer acquirer_key_...

Keys are created from the Acquirer Dashboard and carry an explicit set of permissions. Every request is scoped to the acquirer that owns the key — resources of other acquirers are never visible. Keys may be IP-restricted; requests from non-whitelisted IPs are rejected with HTTP 401. See the Authentication page for details.

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

acquirer_key_*