Attributes
- METHOD TYPEBank Transfer
- PAYMENTS
- PAYOUTS
- REFUNDS
Introduction
DragonPay manages cash and bank transfers for e-commerce payments and payouts in the Philippines.
DragonPay aggregates many payment methods that may not be supported directly by Nuvei.
Supported Countries
- Phillipines
Supported Currencies
- PHP
Payment (Deposit) Flow
Follow these steps to perform a payment using Nuvei REST API integration:
1. Generate a sessionToken
Press here for details.
2. Send a /payment
Request
Perform the payment by sending a /payment
request with its mandatory parameters including:
userTokenId
amount
currency
paymentOption.alternativePaymentMethod
block containing:paymentMethod
: “apmgw_DragonPay“paymentasia_email
paymentasia_phone
deviceDetails
block containing:ipAddress
billingAddress
block containing:firstName
,lastName
,email
,phone
,country
userDetails
block containing:firstName
,lastName
,email
,phone
,country
Example /payment
Request
{ "sessionToken":"<sessionToken from getSessionToken>", "merchantId":"<merchantId>", "merchantSiteId":"<merchantSiteId>", "clientUniqueId":"<unique transaction ID in merchant system>", "clientRequestId":"<unique request ID in merchant system>", "amount":"200", "currency":"PHP", "userTokenId":"<unique customer identifier in merchant system>", "paymentOption":{ "alternativePaymentMethod":{ "paymentMethod":"apmgw_DragonPay", "paymentasia_email":"<paymentasia_email>", "paymentasia_phone":"<paymentasia_phone>" } }, "deviceDetails":{ "ipAddress":"<customer's IP address>" }, "billingAddress":{ "firstName":"John", "lastName":"Smith", "phone":"63756747844", "email":"john.smith@email.com", "country":"PH" }, "userDetails":{ "firstName":"John", "lastName":"Smith", "phone":"63756747844", "email":"john.smith@email.com", "country":"PH" }, "timeStamp":"<YYYYMMDDHHmmss>", "checksum":"<calculated checksum>" }
Payout (Withdrawal) Flow
When performing a /payout
with DragonPay, the following flow including the /accountCapture
method is used before processing the /payout
request:
- Send an
/accountCapture
request that includes the following mandatory fields as shown in the example request below:userTokenId
– Unique identifier of the customer in your systempaymentMethod
: “apmgw_DragonPay“currencyCode
: PHPcountryCode
: PH
Example
/accountCapture
Request{ "sessionToken": "<sessionToken from getSessionToken>", "merchantId": "<your merchantId>", "merchantSiteId": "<your merchantSiteId>", "userTokenId": "<unique customer identifier in merchant system>", "paymentMethod": "apmgw_DragonPay", "currencyCode": "PHP", "countryCode": "PH", }
The request returns a
redirectUrl
.Example
/accountCapture
Response{ "redirectUrl":"https://apmtest.gate2shop.com/ppp/resources/cdn/v1/payment-asia.html?submitUrl=https%3A%2F%2Ftest.safecharge.com%2FAPMNotificationGateway%2FApmConnector%2FbankCapture%2F8FFE7EB73A4ACC53DEAA25CF57350F2D&locale=en_PH&pm=DragonPay", "userTokenId":"test0202", "sessionToken":"2cf95c21-5b01-4e81-b400-29ea73ddf5cc", "internalRequestId":604246858, "status":"SUCCESS", "errCode":0, "reason":"", "merchantId":"221195993304907999", "merchantSiteId":"232618", "version":"1.0" }
- Use
redirectUrl
to redirect the customer to the APM’s account details capture interface for them to enter their account details. - Once the information is captured, Nuvei stores the data in a UPO record and sends a DMN back to you with the newly created
userPaymentOptionId
. - Send a
/payout
request and include theuserPaymentOptionId
, which contains the user’s previously stored APM account details. Press here for an example.
Testing
Online Banking
Bank Name: Test Bank Online
Login ID: pwd
Password: pwd
Over-the-Counter / ATM Banking
Bank Name: Test Bank Online Over-the-Counter
Follow the link you receive in an email and confirm the payment.