Daviplata

Daviplata is an e-money platform that allows transfers from cell phone to cell phone across Colombia using a mobile app. Use this endpoint to process Daviplata payments with a redirect flow only.

This guide provides instructions for Daviplata payments, including request examples, push notification handling, and webhook processing.

Requirements

Before you integrate Daviplata, you need to:

  • Generate an access token through the Authentication endpoint.
  • Configure a public HTTPS callback_url that receives status updates after customers leave the Daviplata interface.
information icon
Important: Daviplata is only available in Colombia and expects COP currency. Contact your Account Manager to enable this payment method for your seller account.

Use case specifics

When you integrate any Getnet solution, market-specific requirements apply. Daviplata is only available in Colombia and only for COP currency. Before you go live, review the resources below to learn about the specific requirements of Colombia:

You can also use test cards to simulate specific scenarios.

Characteristics

The table below summarizes the shared behavior and requirements for Daviplata payments.

CapabilityDetails
Customer interactionPush notification sent to the customer's mobile device through the Daviplata app
ConfirmationAsynchronous: initial PENDING status, then APPROVED or DECLINED through webhook
NotificationsWebhooks for asynchronous status updates when the customer approves or declines
After you create the payment request, the customer's device receives a push notification. The customer opens their Daviplata app to approve or decline the payment. Your callback_url receives status updates through webhooks.

Available features

Use the matrix below to confirm the scenarios currently supported for Daviplata.

Payment flowSupported countriesPurchasesRefundsPartial refundsMultiple refundsPre-authorizations
WalletColombia✅❌❌❌❌

Payment flow

This section guides you through the complete process of implementing Daviplata payments. It covers every stage, from collecting customer information to generating the payment reference and handling the payment confirmation. The diagram below shows an overview of the Daviplata payment process:

1. Create the payment request

Call the Create – Authorize endpoint with the attributes below.

The table outlines the minimum fields required for a Daviplata payment.

AttributeDescriptionRequired value
payment_methodWallet payment methodWALLET
brandBrand's identifierDAVIPLATA
callback_urlWhere status updates are sentYour HTTPS endpoint
amountTransaction amount in centsInteger (e.g. 5000 for €50.00)
currencyISO currency codeCOP
order_idMerchant reference for reconciliationUnique string
information icon
Getnet routes the transaction to the APM (Daviplata) flow automatically when the field brand = daviplata is present.

The following sample request shows how to initialize a Daviplata payment.

json
curl --location --request POST 'https://api.pre.globalgetnet.com/dpm/payments-gwproxy/v2/payments' \ --header 'Content-Type: application/json' --header 'authorization: Bearer <your-token>' --header 'Cookie: route=1764158520.87.3759.130009|e49df8139f6f4c7e96e90a70274c2867' \ --data '{ "idempotency_key": "78b74259-70b6-4fcb-aece-f240b96f2698", "request_id": "198317fb-d931-4fda-9b79-e5ff7929f5c7", "order_id": "35541357001", "data": { "amount": 10000000, "currency": "COP", "customer_id": "c1015cbb-fa91-48f7-b63f-d05bceceda91", "payment": { "payment_id": "962cec20-9d7f-409f-9dd2-4578d69fe98c", "payment_method": "WALLET_PUSH", "brand": "DAVIPLATA", "soft_descriptor": "DAVIPLATA TESTE" }, "additional_data": { "customer": { "customer_id": "123123", "email": "jose.silva@email.net", "document_number": "50506468", "document_type": "SE_NIT", "name": "Jose da Silva", "phone_number": "34700000000", "billing_address": { "street": "R a", "number": "1", "district": "B", "city": "City Z", "state": "SP", "country": "CO", "postal_code": "05781000", "complement": "N/A" } }, "order": { "items": [ { "name": "Item2", "quantity": 1, "sku": "sku1", "price": 10000 } ] } } } }'
The response contains the redirect_url. You must use it to redirect the customer to Daviplata. Getnet immediately stores the transaction as pending. The final payment result is applied only after receiving the webhook callback.
json
{ "idempotency_key": "be278973-35eb-4c45-8619-2800d62b33b6", "seller_id": "2ab3e585-3607-467e-b2e8-420fcd45f48e", "payment_id": "772f951479c6514b1d9c4e8fd4808fe6", "order_id": "ORDER-10187383", "amount": "5000", "currency": "COP", "status": "PENDING", "payment_method": "DAVIPLATA", "received_at": "2025-11-11T11:51:54.569Z", "redirect_url": "https://daviplata.nuvei.com/checkout?reference=XYZ123", "transaction_id": "772f951479c6514b1d9c4e8fd4808fe6", "reason_code": "00", "reason_message": "Waiting for customer approval in Daviplata app." }

2. User experience flow

The steps below show what the customer sees and does to complete a Daviplata payment.

  1. On the cashier screen, the customer or the merchant selects a Daviplata option.
  2. In ‘Payment Details’, the customer selects the document type from the drop-down list. Then they enter the document number in the ‘Document Number’ field.
  3. The customer's mobile device receives a six-digit one-time password (OTP).
  4. On the redirect page, the customer enters the OTP from their mobile device and presses ‘Validate’.
  5. If the transaction succeeds, the customer sees the ‘Success’ screen.

3. Verify payment status

When the customer completes the payment, you receive a webhook notification with the updated payment status. You can also check the payment status using the Get Transaction endpoint.

Business rules

The following rules apply to Daviplata payments:

  • Only COP currency is supported.
  • The amount must be between 99 COP and 10,000,000 COP.
  • The transaction remains pending until the webhook callback is processed.

Read more

  • Review Authentication for token management and security best practices.

On this page

Daviplata