POST https://op-sandbox.paymaya.com/merchant/payments
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
📖
Create Maya Mini App Payment
Open Recipe
Technical Guide:
Related Guide:
Request Payload
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 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 |
Request Body
| Attribute | Type | Format | Description |
|---|---|---|---|
p2mId REQUIRED | string | An identifier for your merchant account; The value will be provided by Maya during onboarding | |
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 |
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 |