Daviplata

Daviplata es una plataforma de dinero electrónico que permite transferencias de teléfono móvil a teléfono móvil en toda Colombia utilizando una aplicación móvil. Este endpoint permite procesar pagos con Daviplata utilizando solo un flujo de redirección.

Esta guía proporciona instrucciones para los pagos con Daviplata, incluyendo ejemplos de peticiones, gestión de notificaciones push y procesamiento de webhooks.

Requisitos

Antes de integrar Daviplata debe:

Generar un token de acceso a través del endpoint de Autenticación.
Configurar una callback_url HTTPS pública que reciba actualizaciones de estado después de que los clientes abandonen la interfaz de Daviplata.

Daviplata solo está disponible en Colombia y espera la moneda COP. Contacte con su Account Manager para habilitar este método de pago en su cuenta de comercio.

Especificidades de Casos de Uso

Al integrar cualquier solución de Getnet, se aplican requisitos específicos de cada mercado. Daviplata solo está disponible en Colombia y exclusivamente para la moneda COP. Para saber más sobre los requisitos específicos de Colombia, asegúrese de revisar los siguientes recursos antes de pasar a producción (go live):

También puede usar tarjetas de prueba para simular escenarios específicos.

Características

La siguiente tabla resume el comportamiento y los requisitos compartidos para los pagos con Daviplata.

Capacidad	Detalles
Interacción con el cliente	Notificación push enviada al dispositivo móvil del cliente a través de la aplicación Daviplata
Confirmación	Asíncrona: estado inicial `PENDING`, luego `APPROVED` o `DECLINED` mediante webhook
Notificaciones	Webhooks para actualizaciones de estado asíncronas cuando el cliente aprueba/rechaza

Tras crear la petición de pago, se enviará una notificación push al dispositivo del cliente. El cliente abre su aplicación Daviplata para aprobar o rechazar el pago. Las actualizaciones de estado se entregan mediante webhooks a su callback_url.

Funcionalidades disponibles

Utilice la siguiente matriz para confirmar los escenarios actualmente soportados para Daviplata.

Flujo de pago	Países soportados	Compras	Reembolsos	Reembolsos parciales	Reembolsos múltiples	Preautorizaciones
Wallet	Colombia	✅	❌	❌	❌	❌

Flujo de pago

Esta sección le guiará a través del proceso completo de implementación de pagos con Daviplata, desde la recopilación de la información del cliente hasta la generación de la referencia de pago y la gestión de la confirmación del pago. El siguiente diagrama ofrece una visión general del proceso de pago con Daviplata:

1. Crear la petición de pago

Llame al endpoint Create – Authorize con los atributos a continuación.

La tabla resume los campos mínimos obligatorios para el pago con Daviplata.

Atributo	Descripción	Valor obligatorio
`payment_method`	Método de pago Wallet	`WALLET`
`brand`	Identificador de la marca	`DAVIPLATA`
`callback_url`	Dónde se envían las actualizaciones de estado	Su endpoint HTTPS
`amount`	Importe de la transacción en céntimos	Entero (ej. `5000` para 50,00 €)
`currency`	Código de moneda ISO	`COP`
`order_id`	Referencia del comercio para conciliación	Cadena única

La transacción se enruta automáticamente al flujo de APM (Daviplata) cuando el campo brand = daviplata está presente.

El siguiente ejemplo de petición muestra cómo inicializar un pago con Daviplata.

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
                    }
                ]
            }
        }
    }
}'

La respuesta contiene la redirect_url, que debe usarse para redirigir al cliente a Daviplata. La transacción se almacena inmediatamente como pending en Getnet. El resultado final del pago se aplica solo tras recibir el callback del webhook.

{
  "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. Flujo de Experiencia del Usuario

En la pantalla de caja, el cliente o el comercio selecciona la opción Daviplata.
En ‘Payment Details’ (Detalles de Pago), el cliente selecciona el tipo de documento en el menú desplegable e introduce el número de documento en el campo ‘Document Number’ (Número de Documento).
Se envía una contraseña de un solo uso (OTP) de seis dígitos al dispositivo móvil del usuario.
En la página a la que es redirigido el cliente, este introduce la OTP que se envió a su dispositivo móvil y, a continuación, pulsa ‘Validate’ (Validar).
Si la transacción se completa con éxito, se muestra la pantalla de ‘Success’ (Éxito).

3. Verificar el estado del pago

Cuando el cliente completa el pago, se envía una notificación de webhook con el estado actualizado del pago. También puede comprobar el estado del pago utilizando el endpoint Get Transaction.

Regras de Negocio

Solo se soporta la moneda COP.
El importe (amount) debe estar entre 99 COP y 10.000.000 COP.
La transacción permanece pending hasta que se procesa el callback del webhook.

Más información

Revise Autenticación para la gestión de tokens y las mejores prácticas de seguridad.