# 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](https://www.google.com/search?q=/en/products/online-payments/regional-api/swagger%23tag/authentication).
* Configurar uma `callback_url` HTTPS pública que recebe atualizações de status após os clientes saírem da interface do Daviplata.
O Daviplata está disponível apenas na Colômbia e espera a moeda COP. Contate o seu Gerente de Contas para habilitar este método de pagamento para a sua conta de estabelecimento.
## 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](https://www.google.com/search?q=/en/articles%3Farticle%3Dcurrency-codes)
* [Tipos de documento](https://www.google.com/search?q=/en/articles%3Farticle%3Ddocument-types)
* [Impostos e regulamentações locais](https://www.google.com/search?q=/en/articles%3Farticle%3Dtaxes-and-regulations)
Você também pode usar [cartões de teste](https://www.google.com/search?q=/en/articles%3Farticle%3Dtest-cards) para simular cenários específicos.
## Características
A tabela abaixo resume o comportamento compartilhado e os requisitos para pagamentos Daviplata.
| Capacidade | Detalhes |
| -------------------- | --------------------------------------------------------------------------------- |
| Interação com o cliente | Notificação push enviada para o dispositivo móvel do cliente através do aplicativo Daviplata |
| Confirmação | Assíncrona: status inicial `PENDING`, depois `APPROVED` ou `DECLINED` via webhook |
| Notificações | Webhooks para atualizações de status assíncronas quando o cliente aprova/recusa |
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 | Países suportados | Compras | Reembolsos | Reembolsos parciais | Reembolsos múltiplos | Pré-autorizações |
| :----------: | :-----------------: | :-------: | :-----: | :-------------: | :--------------: | :----------------: |
| Wallet | Colômbia | ✅ | ❌ | ❌ | ❌ | ❌ |
## 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](https://www.google.com/search?q=/en/products/online-payments/regional-api/swagger%23tag/payments/post/dpm/payments-gwproxy/v2/payments) com os atributos abaixo.
A tabela descreve os campos mínimos obrigatórios para o pagamento Daviplata.
| Atributo | Descrição | Valor obrigatório |
| :--------------- | :------------------------------------ | :------------------------------- |
| `payment_method` | Método de pagamento Wallet | `WALLET` |
| `brand` | Identificador da marca | `DAVIPLATA` |
| `callback_url` | Para onde as atualizações de status são enviadas | Seu endpoint HTTPS |
| `amount` | Valor da transação em centavos | Inteiro (ex.: `5000` para €50.00)|
| `currency` | Código de moeda ISO | `COP` |
| `order_id` | Referência do estabelecimento para conciliação | String única |
> 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.
```json
curl --location --request POST 'https://api.pre.globalgetnet.com/dpm/payments-gwproxy/v2/payments' \
--header 'Content-Type: application/json'
--header 'authorization: Bearer '
--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
}
]
}
}
}
}'
```
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.
```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\. 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](https://www.google.com/search?q=/en/products/online-payments/regional-api/swagger%23tag/payment-record-management/get/dpm/hub-payment-info/v1/payments/info/%7Bpayment_id%7D).
## 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](https://www.google.com/search?q=/en/products/online-payments/regional-api%3Fdoc%3Dauthentication) para gerenciamento de tokens e melhores práticas de segurança.