DaviPlace
Inizia con DaviPlata#
Questa pagina fornisce una guida completa per integrare con successo DaviPlata con DEUNA.
DaviPlata è un portafoglio digitale offerto da Banco Davivienda in Colombia.
Come funziona#
L'integrazione di DEUNA consente agli utenti di completare i pagamenti tramite DaviPlata direttamente dal Payment Widget, senza reindirizzamenti esterni. Il pagamento viene completato utilizzando un OTP (One-Time Password) inviato al numero di telefono registrato dell'utente.
L'intero processo DaviPlata è gestito completamente all'interno del widget.
Processo di pagamento
L'elenco seguente descrive un processo di pagamento valido con DaviPlata:
- L'utente seleziona DaviPlata dal widget.
- Immette il loro numero di documento associato al loro account DaviPlata.
- Un codice OTP viene inviato all'utente.
- Ingressi utente OTP all'interno del widget.
- DEUNA convalida il codice e elabora il pagamento.
- Il widget aggiorna con successo.
Requisiti#
Le credenziali di sandbox e produzione DaviPlata devono essere richieste direttamente tramite il gestore del tuo account DaviPlata.
Ambienti:
- Sandbox: https://api.sandbox.deuna.io
- Produzione: https://api.deuna.io
Procedura di integrazione#
Ora che i requisiti tecnici sono impostati, è possibile avviare l'integrazione.
1. Creare un order_token
Per effettuare un acquisto, è necessario creare un ordine DEUNA.
Fai una richiesta al Creare un Ordine endpoint.
L'API restituisce un order_token, che viene utilizzato durante tutto il flusso.
2. Prendi il order_token
Fai una richiesta al Ordinare endpoint.
Utilizzare questo token per i prossimi passi.
3. Render il widget di pagamento
Dopo aver ricevuto il gettone dell'ordine, è possibile rendere il widget DEUNA.
await DeunaSDK.initPaymentWidget({
orderToken: "<DEUNA order token>",
callbacks: ...,
paymentMethods: [
{
paymentMethod: "voucher",
processors: ["daviplata"],
},
],
});4. Effettua un acquisto
Fai una richiesta al Acquisto V2 endpoint e processare il pagamento.
Restituisce l’ordine elaborato con
{
"order": {
"cash_change": 0,
"currency": "USD",
"discounts": [],
"display_items_total_amount": "",
"display_shipping_amount": "",
"display_sub_total": "",
"display_tax_amount": "",
"display_total_amount": "",
"display_total_discount": "",
"gift_card": [],
"items": [
{
"brand": "",
"category": "",
"color": "",
"description": "Papa Fritas",
"details_url": "",
"discounts": [],
"id": "001",
"image_url": "https://images-staging.getduna.com/95463fb5-6279-4ec3-8ff9-fe07aacd2142/cd928351d12c6b96_domicilio_316_744x744.png?d=600x600",
"isbn": "",
"manufacturer": "",
"name": "Papa Fritas",
"options": "",
"quantity": 1,
"size": "",
"sku": "",
"tax_amount": {
"amount": 44,
"currency": "USD",
"currency_symbol": "$",
"display_amount": ""
},
"taxable": false,
"total_amount": {
"amount": 594,
"currency": "USD",
"currency_symbol": "$",
"display_amount": "",
"display_original_amount": "",
"display_total_discount": "",
"original_amount": 0,
"total_discount": 0
},
"type": "",
"unit_price": {
"amount": 550,
"currency": "USD",
"currency_symbol": "$",
"display_amount": ""
},
"uom": "",
"upc": "",
"weight": {
"unit": "",
"weight": 0
}
},
{
"brand": "",
"category": "",
"color": "",
"description": "Hamburguesa ",
"details_url": "",
"discounts": [],
"id": "002",
"image_url": "https://images-staging.getduna.com/95463fb5-6279-4ec3-8ff9-fe07aacd2142/cd928351d12c6b96_domicilio_51330_744x744_1646338877.png?d=600x600",
"isbn": "",
"manufacturer": "",
"name": "Hamburguesa",
"options": "",
"quantity": 2,
"size": "",
"sku": "",
"tax_amount": {
"amount": 88,
"currency": "USD",
"currency_symbol": "$",
"display_amount": ""
},
"taxable": false,
"total_amount": {
"amount": 3088,
"currency": "USD",
"currency_symbol": "$",
"display_amount": "",
"display_original_amount": "",
"display_total_discount": "",
"original_amount": 0,
"total_discount": 0
},
"type": "",
"unit_price": {
"amount": 1500,
"currency": "USD",
"currency_symbol": "$",
"display_amount": ""
},
"uom": "",
"upc": "",
"weight": {
"unit": "",
"weight": 0
}
}
],
"items_total_amount": 3682,
"metadata": {
"key1": "NO REQUERIDO",
"key2": "NO REQUERIDO"
},
"order_id": "order116",
"payment": {
"data": {
"amount": {
"amount": 3770,
"currency": "USD"
},
"authorization_3ds": {
"html_content": "<div></div>",
"url_challenge": "",
"version": "1.1.1"
},
"authorization_code": "TEST00",
"created_at": "2022-07-22 20:22:48.408419489 +0000 UTC",
"customer": {
"email": "jhondoe@deuna.com",
"id": "xxxxxx-0eb3-450f-8b26-4ff23208470f"
},
"from_card": {
"card_brand": "Visa",
"first_six": "411111",
"last_four": "1111"
},
"id": "order116",
"installments": {
"installment_amount": 5999,
"installment_rate": 0.12,
"installment_type": "MCI",
"installments": 3,
"plan_id": "7471ed27-094d-44c4-a62d-225644b782f7",
"plan_option_id": "87309ea8-3942-4fdf-95ec-ce29a792aff2"
},
"merchant": {
"id": "9a85e296-cc3d-454b-b591-208d6e538126",
"store_code": "all"
},
"metadata": {
"authorization_code": "TEST00"
},
"method_type": "credit_card",
"processor": "paymentez",
"reason": "",
"status": "processed",
"updated_at": "2022-07-22 20:22:48.408809765 +0000 UTC"
}
},
"redirect_url": "",
"scheduled_at": "",
"shipping": null,
"shipping_address": {
"additional_description": "Piso 9",
"address_type": "home",
"address1": "Av. de los Incas 15-33, Ambato 180202, Ecuador",
"address2": "Av. de los Incas 15-33, Ambato 180202, Ecuador",
"city": "Ambato",
"country_code": "EC",
"created_at": "0001-01-01T00:00:00Z",
"first_name": "Jhon",
"id": 0,
"identity_document": "146565656",
"is_default": true,
"last_name": "Doe",
"lat": -1.2480678792202227,
"lng": -78.62532788804577,
"phone": " 946565665",
"state_name": "Tungurahua",
"updated_at": "0001-01-01T00:00:00Z",
"user_id": "xxxxx4e2-xxxx-xxxx-xxxx-xxxxx5b7b2e",
"zipcode": "180202"
},
"shipping_amount": 0,
"shipping_method": null,
"shipping_methods": [],
"shipping_options": {},
"status": "succeeded",
"store_code": "",
"sub_total": 3550,
"tax_amount": 132,
"timezone": "",
"total_amount": 3770,
"total_discount": 0,
"user_instructions": "Piso 9",
"webhook_urls": null
},
"order_token": "0b98dbe8-d265-49bc-b80d-536cea46509c"
}Test dei dati#
Utilizzare i seguenti dati per il vostro ambiente di test:
- Numero di documento:
1134568019 - Tipo di documento:
CC - Importo: Meno
COP 10,000. Andare di seguito innesca uno stato di pagamento in sospeso.
Per testare un pagamento respinto, è possibile utilizzare un numero di documento come 9999999999 o inviare un importo superiore a quello COP 10,000.