# Daviplata

![](https://static-devportal-ux.sensedia-eng.com/Pagonxt/staging/documentations/daviplata-1765289963748-b8rc08i4.png)

Daviplata is an e-money platform that allows transfers from cell phone to cell phone across Colombia using a mobile app. This endpoint allows processing **Daviplata payments** using a **redirect flow only**.

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

## Requirements

Before integrating Daviplata you need to:

* Generate an access token through the [Authentication endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/authentication).
* Configure a public HTTPS `callback_url` that receives status updates after customers leave the Daviplata interface.

<Callout type="warning">

Daviplata is only available in Colombia and expects COP currency. Contact your Account Manager to enable this payment method for your seller account.

</Callout>

## Use Cases Specifics

When integrating any Getnet solution, market-specific requirements apply. Daviplata is only available in Colombia and only for COP currency. To know more about the specific requirements of Colombia, be sure to review the resources below before you go live:

* [Currency codes](https://docs.globalgetnet.com/en/articles?article=currency-codes)
* [Document types](https://docs.globalgetnet.com/en/articles?article=document-types)
* [Local taxes and regulations](https://docs.globalgetnet.com/en/articles?article=taxes-and-regulations)

You can also use [test cards](https://docs.globalgetnet.com/en/articles?article=test-cards) to simulate specific scenarios.

## Characteristics

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

| Capability           | Details                                                                           |
| -------------------- | --------------------------------------------------------------------------------- |
| Customer interaction | Push notification sent to customer's mobile device via Daviplata app              |
| Confirmation         | Asynchronous: initial `PENDING` status, then `APPROVED` or `DECLINED` via webhook |
| Notifications        | Webhooks for asynchronous status updates when customer approves/declines          |

After you create the payment request, a push notification is sent to the customer's device. The customer opens their Daviplata app to approve or decline the payment. Status updates are delivered via webhooks to your `callback_url`.

## Available features

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

| Payment flow | Supported countries | Purchases | Refunds | Partial refunds | Multiple refunds | Pre-authorizations |
| :----------: | :-----------------: | :-------: | :-----: | :-------------: | :--------------: | :----------------: |
|    Wallet    |       Colombia      |     ✅     |    ❌    |        ❌        |         ❌        |          ❌         |

## Payment flow

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

![](https://static-devportal-ux.sensedia-eng.com/Pagonxt/production/documentations/diagram-daviplata-1772817450723-0e1lav18.png)

## 1. Create the payment request

Call the [Create – Authorize endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payments/post/dpm/payments-gwproxy/v2/payments) with the attributes below.

The table outlines the minimum fields required for Daviplata payment.

| Attribute        | Description                           | Required value                   |
| :--------------- | :------------------------------------ | :------------------------------- |
| `payment_method` | Wallet payment method                 | `WALLET`                         |
| `brand`          | Brand's identifier                    | `DAVIPLATA`                      |
| `callback_url`   | Where status updates are sent         | Your HTTPS endpoint              |
| `amount`         | Transaction amount in cents           | Integer (e.g. `5000` for €50.00) |
| `currency`       | ISO currency code                     | `COP`                            |
| `order_id`       | Merchant reference for reconciliation | Unique string                    |

> The transaction is routed to the APM (Daviplata) flow automatically when the field `brand = daviplata` is present.

The following sample request shows how to initialize an 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`, which **must be used to redirect the customer to Daviplata**.
The transaction is immediately stored as `pending` in Getnet. 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

1. On the cashier screen, the customer or the merchant selects a Daviplata option.
   ![](https://static-devportal-ux.sensedia-eng.com/Pagonxt/staging/documentations/passo1-1765290423703-58xof2ay.webp)
2. In ‘Payment Details’, the customer selects the document type from the drop-down list and enters the document number in the ‘Document Number’ field.
   ![](https://static-devportal-ux.sensedia-eng.com/Pagonxt/staging/documentations/passo2-1765290436597-7d36fbtx.webp)
3. A six digit one-time password (OTP) is sent to the mobile device of the user.
4. On the page the customer is redirected to, the customer enters the OTP that was sent to the customer's mobile device and then presses ‘Validate’.
   ![](https://static-devportal-ux.sensedia-eng.com/Pagonxt/staging/documentations/passo3-1765290476870-f6fx3glo.webp)
5. If the transaction is completed successfully, the ‘Success’ screen is displayed. <img height="412" width="506" src="https://static-devportal-ux.sensedia-eng.com/Pagonxt/staging/documentations/passo4-1765290487213-wqpofpbh.webp" />

### 3. Verify payment status

When the customer completes the payment, a webhook notification is sent with the updated payment status. You can also check the payment status using the [Get Transaction endpoint](https://docs.globalgetnet.com/en/products/online-payments/regional-api/swagger#tag/payment-record-management/get/dpm/hub-payment-info/v1/payments/info/{payment_id}).

## Business Rules

* Only `COP` currency is supported.
* Amount must be between **99 COP and 10,000,000 COP**.
* Transaction remains `pending` until webhook callback is processed.

## Read more

* Review [Authentication](/en/global-api/sep-api/first-steps-api/authentication) for token management and security best practices.