Daviplata

O Daviplata é uma carteira digital que permite transferências de celular para celular em toda a Colômbia usando um aplicativo móvel. Este endpoint permite o processamento de pagamentos Daviplata usando apenas fluxo de redirecionamento.

Este guia fornece instruções para pagamentos Daviplata, incluindo exemplos de requisição, tratamento de notificação push e processamento de webhook.

Requisitos

Antes de integrar o Daviplata, você precisa:

• Gerar um token de acesso através do endpoint de Autenticação.
• Configurar uma callback_url HTTPS pública que recebe atualizações de status após os clientes saírem da interface do Daviplata.

Especificidades de Casos de Uso

Ao integrar qualquer solução Getnet, aplicam-se requisitos específicos do mercado. O Daviplata está disponível apenas na Colômbia e somente para a moeda COP. Para saber mais sobre os requisitos específicos da Colômbia, certifique-se de revisar os recursos abaixo antes de entrar em produção (go live):

• Códigos de moeda
• Tipos de documento
• Impostos e regulamentações locais

Você também pode usar cartões de teste para simular cenários específicos.

Características

A tabela abaixo resume o comportamento compartilhado e os requisitos para pagamentos Daviplata.

Após criar a requisição de pagamento, uma notificação push é enviada para o dispositivo do cliente. O cliente abre o seu aplicativo Daviplata para aprovar ou recusar o pagamento. As atualizações de status são entregues via webhooks para a sua callback_url.

Funcionalidades disponíveis

Use a matriz abaixo para confirmar os cenários atualmente suportados para o Daviplata.

Fluxo de pagamento

Esta seção o guia através do processo completo de implementação de pagamentos Daviplata, desde a coleta de informações do cliente até a geração da referência de pagamento e o tratamento da confirmação de pagamento. O diagrama abaixo fornece uma visão geral do processo de pagamento Daviplata:

1. Criar a requisição de pagamento

Chame o endpoint Create – Authorize com os atributos abaixo.

A tabela descreve os campos mínimos obrigatórios para o pagamento Daviplata.

A transação é roteada para o fluxo de APM (Daviplata) automaticamente quando o campo brand = daviplata está presente.

O exemplo de requisição a seguir mostra como inicializar um pagamento 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": "[email protected]",
                "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
                    }
                ]
            }
        }
    }
}'

A resposta contém a redirect_url, que deve ser usada para redirecionar o cliente para o Daviplata. A transação é imediatamente armazenada como pending na Getnet. O resultado final do pagamento é aplicado apenas após o recebimento do callback via 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. Fluxo de Experiência do Usuário

1. Na tela do caixa, o cliente ou o estabelecimento seleciona a opção Daviplata.
2. Em ‘Payment Details’ (Detalhes do Pagamento), o cliente seleciona o tipo de documento na lista suspensa e insere o número do documento no campo ‘Document Number’ (Número do Documento).
3. Uma senha de uso único (OTP) de seis dígitos é enviada para o dispositivo móvel do usuário.
4. Na página para a qual o cliente é redirecionado, o cliente insere a OTP que foi enviada ao seu dispositivo móvel e, em seguida, pressiona ‘Validate’ (Validar).
5. Se a transação for concluída com sucesso, a tela de ‘Success’ (Sucesso) é exibida.

3. Verificar status do pagamento

Quando o cliente conclui o pagamento, uma notificação de webhook é enviada com o status atualizado do pagamento. Você também pode verificar o status do pagamento usando o endpoint Get Transaction.

Regras de Negócio

• Apenas a moeda COP é suportada.
• O valor (amount) deve estar entre 99 COP e 10.000.000 COP.
• A transação permanece pending até que o callback do webhook seja processado.

Leia mais

• Revise Autenticação para gerenciamento de tokens e melhores práticas de segurança.