Authorize card payment

Charges the saved customer card linked to the card's active reroute. Once the charge is captured, Mamo queues a top-up of your Debit card account from your Payments balance for the same amount, always in AED (a 100 USD charge tops up 100 AED). The top-up runs asynchronously after fraud checks and can be held or blocked, so a 201 doesn't mean the card balance has been topped up yet.

Identify the card by its issuing-platform ID (card_platform_id), not the card identifier, and send the amount and currency to charge. Set up the reroute first with Create card reroute.

Returns {"success": true} with 201 when the charge is captured. The call returns 422 if the card has no active reroute (Card does NOT have reroutes) or the charge isn't captured, and 404 if no card with that platform ID belongs to your business.

🚧

Available on request

In production this endpoint only works for businesses Mamo has enabled, and returns 403 for everyone else. Email [email protected] to get started. It is open in the sandbox.

Body Params
string
required

The card's issuing-platform ID (not the card identifier) for the card whose active reroute should be charged.

number
required

Amount to authorize.

string
required

Currency of the amount.

Headers
string

A unique key, such as a UUID, that makes it safe to retry this request. Reuse the same key when you retry. See Idempotency.

Responses

429

Too many requests. You sent more than 100 requests in 30 seconds from one IP address. This response has no JSON body. See Rate limits.

500

Unexpected error

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json