Attributes

• METHOD TYPEE-wallet
• PAYMENTS
• PAYOUTS
• REFUNDS
• RECURRING

Introduction

Daviplata is an e-money platform that allows transfers from cell phone to cell phone across Colombia using a mobile app. Cash that is sent can be withdrawn at Banco Davivienda ATMs.

Supported Countries

• Colombia

Supported Currencies

• COP

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_Daviplata“
  • daviplata_typeFiscalNumber – Customer’s document type
  • daviplata_fiscalNumber – Customer’s document number
• deviceDetails class containing: ipAddress
• billingAddress class containing: firstName, lastName, email, country
• userDetails class containing: firstName, lastName, email, country

Example /payment Request

{
  "sessionToken":"<sessionToken from /getSessionToken>",
  "merchantId":"<your merchantId>",
  "merchantSiteId":"<your merchantSiteId>",
  "clientRequestId":"<unique request ID in merchant system>",
  "amount":"1000",
  "currency":"COP",
  "userTokenId":"<unique customer identifier in merchant system>",
  "clientUniqueId":"<unique transaction ID in merchant system>",
  "paymentOption":{
    "alternativePaymentMethod":{
      "paymentMethod":"apmgw_Daviplata"
      "daviplata_typeFiscalNumber":"PP"
      "daviplata_fiscalNumber":"123456789"
    }
  },
  "deviceDetails":{
    "ipAddress":"<customer's IP address>"
  },
  "billingAddress":{
    "firstName": "John",
    "lastName": "Smith",
    "email":"[email protected]",
    "country":"CO"
  },
  "userDetails":{
    "firstName": "John",
    "lastName": "Smith",
    "email":"[email protected]",
    "country":"CO"
  },
  "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.

User Experience

1. On the cashier screen, the user selects a Daviplata option.

2. In ‘Payment Details’, the user selects the document type from the drop-down list and enters the document number in the ‘Document Number’ field.

A six digit one-time password (OTP) is sent to the mobile device of the user.

3. On the page the user is redirected to, the user enters the OTP that was sent to the user’s mobile device and then presses ‘Validate’.

If the transaction is completed successfully, the ‘Success’ screen is displayed.

Appendix – Fiscal Number Types