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

Implementation Details

Payment (Deposit)

Click tab to open…

{
  "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>"
    }
  },
  "billingAddress":{
    "country":"PH",
    "email":"john.smith@email.com"
  },
  "deviceDetails":{
    "ipAddress":"127.0.0.1"
  },
  "userDetails":{
    "firstName":"John",
    "lastName":"Smith",
    "phone":"6175551414",
    "email":"john.smith@email.com",
    "country":"PH"
  },
  "timeStamp":"<YYYYMMDDHHmmss>",
  "checksum":"<calculated checksum>"
}

For this APM, the following parameters are mandatory:

• userTokenId
• amount
• currency
• paymentOption.alternativePaymentMethod block containing:
  • paymentMethod: "apmgw_DragonPay"
  • paymentasia_email
  • paymentasia_phone
• deviceDetails block containing: ipAddress
• billingAddress block containing: country, email
• userDetails block containing: firstName, lastName, email, phone, country

Payout (Withdrawal)

When performing a /payout with DragonPay, the following flow including the /accountCapture method is used before processing the /payout request:

1. 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 system
   • paymentMethod: “apmgw_DragonPay“
   • currencyCode: PHP
   • countryCode: 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.

2. Use redirectUrl to redirect the customer to the APM’s account details capture interface for them to enter their account details.
3. 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.
4. Send a /payout request and include the userPaymentOptionId representing the captured details returned by the /accountCapture request. Press here for an example.

User Experience

Payment (Deposit)

1. Enter the amount to deposit, and press Pay Now.
2. Complete the transaction based on available payment method options. Different integrations may have different aggregated payment methods available, and they each have their own transaction flows, which may be specified on other APM pages.

Payout (Withdrawal)

1. Enter the amount to withdraw and press Withdraw.
   You are redirected to a bank capture page.
2. Enter the necessary bank details and press Confirm.
   A withdrawal request is created.

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.