POST https://op-sandbox.paymaya.com/merchant/payments/{id}/execute
This API endpoint uses Bearer Authentication, which relies on the Client Credentials Token (access_token
) generated during OAuth 2.0 Authentication using the client_credentials
grant type. You must provide this token as part of the Authorization header.
--header Authorization: Bearer <access_token>
Recipes
📖
Execute Maya Mini App Payment
Open Recipe
Technical Guide:
Related Guide:
Request Payload
Path Parameter
Attribute | Type | Format | Description |
---|---|---|---|
id REQUIRED | string | UUIDv4 | The id referencing to the payment record created and returned by Maya during the Create Maya Mini App Payment |
Request Header
Attribute | Type | Format | Description |
---|---|---|---|
Content-Type REQUIRED | string | application/json | Specifies the media type of the request |
Request-Reference-No REQUIRED | string | UUIDv4 | Unique reference identifier for tracking the request |
Authorization REQUIRED | string | JWS | The Client Credentials Token (access_token ) generated by Maya during OAuth 2.0 Authentication using the client_credentials grant typeExample: Bearer {access_token} |
X-Authorization REQUIRED | string | JWE | The Customer Access Token (accessToken ); a valid customer access token obtained from Maya through either your session URL or acquired by refreshing the tokens , whichever is the most recent or valid value |
Response Payload
Response Body
Attribute | Type | Format | Description |
---|---|---|---|
id REQUIRED | string | UUIDv4 | Payment ID referencing to the payment record created |
p2mId REQUIRED | string | An identifier for your merchant account; The value will be provided by Maya during onboarding | |
requestReferenceNumber REQUIRED | string | AN(36) | Value provided by the merchant in the Request-Reference-No parameter of the Create Payment request |
amount REQUIRED | object | An object for the base transaction amount | |
amount.currency REQUIRED | string | ISO 4217 Alpha-3 | Currency code of the amount |
amount.value REQUIRED | float | 0.001 to 9999999999.99 | Transaction amount in the exponent/decimal notation of the provided currency |
fee REQUIRED | object | An object for the base fee amount | |
fee.currency REQUIRED | string | ISO 4217 Alpha-3 | Currency code of the fee |
fee.value REQUIRED | float | 0.001 to 9999999999.99 | Fee amount in the exponent/decimal notation of the provided currency |