Pagos y pedidos bancarios

En esta página

Payload completo de pedido bancario
Modela el contexto de negocio
Lista de verificación de producción

Utiliza DEUNA para orquestar experiencias de pago dentro de los viajes bancarios digitales, manteniendo el contexto del producto y del cliente asociado a cada intento. El pedido proporciona una referencia comercial estable a través de proveedores, reintentos, estados y operaciones.

Flujo de servidor de confianzaCrea y procesa pedidos desde una infraestructura bancaria controlada con credenciales de API privadas.Contexto de canalIdentifica viajes móviles, Web, en tienda o asistidos sin cambiar el contrato de pago.Rastreo operativoConcilia la referencia bancaria, el token de pedido de DEUNA, el estado de pago y las actualizaciones asíncronas.

Payload completo de pedido bancario#

El ejemplo modela un pago de cuenta de crédito dirigido por el cliente. Las referencias de producto y cuenta son metadatos definidos por el comerciante; evita incluir secretos o números de cuenta completos en el payload.

Payload completo de la orden

Banca

Producto financiero, referencia de cuenta enmascarada, cliente, canal y descriptor para un pago de cuenta.

Abrir guía de la industria

descriptionstatement_descriptorinitiator_typemetadata

Cuerpo de la solicitudJSON

{
  "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"
    }
  }
}

Modela el contexto de negocio#

Requisito	Campos de orden
Referencia de transacción bancaria	Estable `order_id` más una referencia de metadatos enmascarada o tokenizada
Producto financiero	Elemento de servicio `category`, `type`y nombrado `metadata.product`
Cliente y canal	`payer_info`, `initiator_type`y `channel_type`
Estado de cuenta del cliente	`description` y compatible con proveedores `statement_descriptor`
Resultado final	DEUNA `order_token`, estado de pago y eventos de webhook verificados

Lista de verificación de producción#

Definir qué identificador bancario se convierte en el comerciante inmutable order_id.
Mantener las referencias de la cuenta enmascaradas o tokenizadas y excluir las credenciales de los metadatos.
Aplicar la idempotencia a cada intento de negocio y reconciliar los tiempos de espera con el pedido original.
Validar los descriptores de la cuenta y los métodos de pago admitidos con los proveedores seleccionados.
Probar los escenarios de autenticación, límite, pendiente, rechazo, reversión, reembolso y envío duplicado.

Continuar con Claves de autenticación y API, Idempotenciay Ganchos web.