Pagamenti bancari e ordini
Orchestrare pagamenti e ordini di servizi finanziari con il contesto cliente, canale, estratto conto e riconciliazione.
In questa pagina
Utilizzare la piattaforma DEUNA per orchestrare le esperienze di pagamento all'interno dei percorsi di digital banking, mantenendo il contesto del prodotto finanziario e del cliente associato a ogni tentativo. L'ordine fornisce un riferimento commerciale stabile tra i fornitori, i tentativi, gli stati e le operazioni.
Payload completo per l'ordine bancario#
L'esempio modella un pagamento di un conto di credito gestito dal cliente. Riferimenti a prodotto e account sono metadati definiti dal commerciante; evitare di includere segreti o numeri di conto completi nel payload.
Banche
Prodotto finanziario, riferimento conto mascherato, cliente, canale e descrittore per un pagamento sul conto.
descriptionstatement_descriptorinitiator_typemetadata{
"order_type": "DEUNA_CHECKOUT",
"order": {
"order_id": "bank-payment-883104",
"store_code": "digital-banking",
"currency": "USD",
"items_total_amount": 12500,
"sub_total": 12500,
"total_tax_amount": 0,
"total_amount": 12500,
"items": [
{
"id": "credit-account-payment",
"sku": "CARD-PAYMENT",
"name": "Credit account payment",
"description": "Customer-directed account payment",
"quantity": 1,
"category": "financial_services",
"type": "service",
"taxable": false,
"unit_price": {
"amount": 12500,
"currency": "USD",
"currency_symbol": "$"
},
"total_amount": {
"amount": 12500,
"original_amount": 12500,
"currency": "USD",
"currency_symbol": "$",
"total_discount": 0
},
"tax_amount": {
"amount": 0,
"currency": "USD",
"currency_symbol": "$"
}
}
],
"payer_info": {
"email": "alex@example.com",
"external_registration_date": "2022-08-14T10:30:00Z"
},
"description": "Payment to account ending in 8842",
"statement_descriptor": "BANK ACCOUNT PMT",
"initiator_type": "customer",
"channel_type": "mobile_app_android",
"metadata": {
"vertical": "banking",
"account_reference": "acct_••••8842",
"product": "credit_card",
"customer_segment": "premium"
},
"callback_urls": {
"on_success": "https://merchant.example.com/payments/success",
"on_pending": "https://merchant.example.com/payments/pending",
"on_reject": "https://merchant.example.com/payments/rejected",
"on_canceled": "https://merchant.example.com/payments/canceled",
"on_failed": "https://merchant.example.com/payments/failed"
}
}
}Modella il contesto aziendale#
| Requisito | Ordinare i campi |
|---|---|
| Riferimento alla transazione bancaria | Stabile order_id oltre a un riferimento di metadati mascherato o tokenizzato |
| Prodotto finanziario | Elemento di servizio category, typee denominato metadata.product |
| Cliente e canale | payer_info, initiator_typee channel_type |
| Estratto conto del cliente | description e compatibile con il fornitore statement_descriptor |
| Risultato finale | DEUNA order_tokenstato del pagamento e eventi webhook verificati |
Controllo di avvio#
- Definisci quale identificatore bancario diventa il merchant immutabile
order_id. - Mantieni i riferimenti all'account mascherati o tokenizzati ed escludi le credenziali dai metadati.
- Applica l'idempotenza a ogni tentativo commerciale e fai corrispondere i timeout con l'ordine originale.
- Valida i descrittori dello statement e i metodi di pagamento supportati con i fornitori selezionati.
- Testa scenari di autenticazione, limite, in attesa, rifiuto, annullamento, rimborso e invio duplicato.
Continua con Autenticazione e chiavi API, Il Gateway applica l’idempotenza a questa operazione. Invia unae Webhook.