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.

906906

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:

CodeDescription
coins_peso_walletPay with the user's Peso Coins wallet.
cash_paymentPay 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_depositPay over the counter at any 7-eleven convenience store.
mlhuillier_depositPay over the counter at any Mlhuillier branch.
cebuana_lhuillier_depositPay over the counter at any Cebuana Lhuillier branch.
bayad_depositPay over the counter at any Bayad Center branch.
palawan_depositPay 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.

844844

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.

844844

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.

844844
Language