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

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 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.

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 the userPaymentOptionId, which contains the user’s previously stored APM account details. Press here for an example.

Testing

Online Banking

Bank Name: Test Bank Online

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.

DragonPay