Create a new payment request
Quick Start
Obtain an OAuth2 token and then replace YOUR_TOKEN in the following example.
curl -X POST \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json;charset=UTF-8" \
-H "Accept: application/json" \
-d '{"payer_contact_info": "[email protected]","receiving_account": "5411c4604c9b45b8b74837c84daa0f4c","amount": 20,"message": "Thanks for all the fish!"}' \
"https://coins.ph/api/v3/payment-requests/"
Introduction
A Payment Request is an attempt of a particular payee to ask for funds from another person. The payer need not be an existing coins user. To request for payment, the payee only needs to know at least one of the payor's details:
- phone number
- email address
A successful payment request will send a notification through email or phone number, with a link where the payer may select a payment option. The payer could then select one of the currently available payment options. All options available to non-coins users are also available for current coins users.
Payment Options
You can specify specific payment options that a payment request will present to the paying user. Options that can be passed are the following:
| Code | Description |
|---|---|
| coins_peso_wallet | Pay with the user's Peso Coins wallet. |
| cash_payment | Pay with any of the payment options that requires the user to pay over the counter. (Currently won't include bayad_deposit and palawan_deposit) |
| seven_connect_deposit | Pay over the counter at any 7-eleven convenience store. |
| mlhuillier_deposit | Pay over the counter at any Mlhuillier branch. |
| cebuana_lhuillier_deposit | Pay over the counter at any Cebuana Lhuillier branch. |
| bayad_deposit | Pay over the counter at any Bayad Center branch. |
| palawan_deposit | Pay over the counter at any Palawan Pawnshop branch. |
Coins Account
Coins users can select this option to use one of their wallets to pay for the payment request. Funds will be transferred from the payers selected wallet to the payee's account.
7-Eleven Deposit
Payers may choose this option to pay for the payment request by depositing funds through a 7-Eleven store. A 7-Connect reference number will be generated, along with a barcode which a payer could present to the store clerk for scanning.
M Lhuillier
Payers may choose this option to pay for the payment request by depositing funds through an MLhuillier outlet. An EPay transaction code will be generated for the payment request. Funds for the payment request will be transferred to the payee's account once payment has been made through the specified transaction code.
