Attributes

• METHOD TYPEE-wallet; Bank Transfer
• PAYMENTS
• PAYOUTS
• REFUNDS
• RECURRING

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 class containing:
  • paymentMethod: “apmgw_DragonPay“
  • paymentasia_email
  • paymentasia_phone
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, email, phone, country
• userDetails class 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":"[email protected]",
    "country":"PH"
  },
  "userDetails":{
    "firstName":"John",
    "lastName":"Smith",
    "phone":"63756747844",
    "email":"[email protected]",
    "country":"PH"
  },
  "timeStamp":"<YYYYMMDDHHmmss>",
  "checksum":"<calculated checksum>"
}

After the transaction is processed, Nuvei sends a Direct Merchant Notification (DMN) that includes the result of the transaction to the URL provided in urlDetails.notificationUrl, which Nuvei recommends including in the /payment request.

Payout (Withdrawal) Flow

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

1. Generate a sessionToken. Press here for details.
2. Send an /accountCapture request that includes the following mandatory fields as shown in the example request below:
   • userTokenId – Unique customer identifier in merchant 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"
     }

3. Use redirectUrl to redirect the customer to the APM’s account details capture interface for them to enter their account details.
4. Once the information is captured, Nuvei stores the data in a userPaymentOptionId (UPO) identifier, and sends a  back to you with the newly created userPaymentOptionId.
5. Send a /payout request and include the userPaymentOptionId, which contains the user’s previously stored APM account details. Press here for an example.

After the transaction is processed, Nuvei sends a DMN that includes the result of the transaction to the URL provided in urlDetails.notificationUrl, which Nuvei recommends including in the /payout request.

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.