Initiate Send

post

https://sandbox.api.maya.ph/v1/remittances/send

Use this API to initiate the sending of a remittance transaction. This will perform all the validations for the requested remittance to be processed. This API returns the id which you will use to confirm the processing of the remittance transaction.

Body Params

Initiate send request details

source_account

object

required

Details of the financial account to be debited of the principal amount including commissions (if any) and fees. This account is validated against the owner of the credentials used to invoke the API.

receiver_account

object

required

Details of the receiver's financial account where the amount will be credited.

sender

object

required

Sender KYC information.

receiver

object

required

Receiver KYC information.

amount

object

required

Transaction amount.

origin_country

string

required

length between 2 and 2

[A-Z]{2}

Country where the transaction originated.

transaction_purpose

string

required

length between 1 and 100

[^=%{}<>;]*

Purpose of the transaction.

relationship_to_receiver

string

required

length between 1 and 100

[^=%{}<>;]*

Sender's relationship to the receiver.

ach_channel

string

enum

ACH rail used to send the funds to the receiver's bank. Only applicable when the receiver's receiver_account.financial_institution_code is not a Maya target (i.e. not PAPHPHM1XXX Maya wallet and not MYYAPHM2XXX Maya Bank). Allowed values are INSTAPAY and PESONET (case-insensitive). When omitted for a non-Maya receiver, INSTAPAY is used by default. The field must be omitted when the receiver is a Maya wallet or Maya Bank account; otherwise the request is rejected.

Allowed:

additional_information

object

Any additional information that is needed for the transaction to push through. Nested objects are not allowed.

Headers

x-idempotency-key

string

required

length between 36 and 36

^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Use a unique identifier for the request, must be UUID. This identifier enforces idempotency for repeated requests. If a duplicate request is detected, an error will be thrown.

x-originator-transaction-id

string

required

The transaction identifier provided by the partner. This should be unique per partner transaction. If a request using the same id is detected, an error will be thrown

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201When the service successfully validates the requested transaction initiated by the requestor.

400When one or more parameters, headers, or fields have invalid values.

422When a validation error occurs while processing the request.

500When the service encounters a system error.

503When the service encounters an intermittent availability problem. Re-transactions may succeed.

504When the service encounters any form of timeouts while processing the request.