Crear pago

Usa esta operación desde el backend del comercio para crear y pagar una orden en línea en una sola solicitud. También puedes proporcionar el token de una orden existente. DEUNA aplica las conexiones de pago y el comportamiento de enrutamiento, riesgo y captura configurados para el comercio.

Enviar la selección de cuotasPreguntar a Athia sobre esto#

Cuando el cliente selecciona una opción devuelta por Listar las opciones de cuotas, conservar tanto el número de cuotas como el ID de la opción:

{
  "payment_source": {
    "method_type": "credit_card",
    "card_info": {
      "card_id": "CARD_ID",
      "installments": 6,
      "installment": {
        "plan_option_id": "a4756a5f-7f9b-414d-8712-e3a9da2be337"
      }
    }
  }
}

El número de cuotas y el ID de la opción deben coincidir. El ID de la opción identifica la opción de campaña/proveedor de DEUNA; el número indica el número de cuotas seleccionado para el procesamiento de pago. Consulte Cuotas para la elegibilidad de la campaña y el flujo completo.

Envía un pago con tarjeta recurrentePreguntar a Athia sobre esto#

Los campos de recurrencia pertenecen dentro del orderen línea. La transacción inicial iniciada por el titular establece la credencial recurrente:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "TOKENIZED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-initial",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "customer",
    "recurrence": {
      "first_time_use": true,
      "scheduled": true,
      "bill_reference": "subscription-1001"
    }
  }
}

Después del primer cargo exitoso, conserva el order.recurrence.recurrence_iddevuelto. Envía ese valor con el cargo posterior iniciado por el comercio:

{
  "payer_info": {
    "email": "buyer@example.com"
  },
  "payment_source": {
    "method_type": "credit_card",
    "payment_method": "STORED_PAYMENT_METHOD"
  },
  "order_type": "DEUNA_CHECKOUT",
  "order": {
    "order_id": "subscription-1001-002",
    "store_code": "main",
    "currency": "USD",
    "sub_total": 1000,
    "total_tax_amount": 0,
    "total_amount": 1000,
    "initiator_type": "merchant",
    "recurrence": {
      "first_time_use": false,
      "scheduled": true,
      "recurrence_id": "RECURRING_CREDENTIAL_ID",
      "bill_reference": "subscription-1001"
    }
  }
}

Usa el nombre de campo exacto recurrence_id; es el contrato JSON público utilizado por Purchase V2. Un cargo posterior sin un identificador válido no puede vincularse a la credencial de recurrencia almacenada para el procesador seleccionado.

Elige cómo proporcionar la ordenPreguntar a Athia sobre esto#

Comience con un pedido completo de la industriaPreguntar a Athia sobre esto#

El order acepta el mismo contexto empresarial modelado por la API de Orders. Cada ejemplo de industria se abre con la solicitud recomendada de Purchase V2 en línea y también permite inspeccionar la solicitud opcional de crear primero la orden.

RespuestaPreguntar a Athia sobre esto#

Devuelve el pedido procesado, incluyendo su order_tokentipo de orden, estado resultante, información de pago e información de suscripción, cuando corresponda. Trate el estado devuelto como autoritativo. Si permanece sin resolver, obtenga el pedido original después de que DEUNA procese la actualización del proveedor asíncrona.

Códigos de estado

IdempotenciaPreguntar a Athia sobre esto#

El Portal aplica idempotencia a esta operación de compra. enviar un establo X-Idempotency-Key para el mismo intento comercial y reutilizar la misma clave y cuerpo después de un tiempo de espera de la red. Utilice una nueva clave para un intento materialmente diferente.

• Genere la clave en el backend del comerciante, no en el navegador o el código móvil.
• Nunca reutilice una clave con un cuerpo de solicitud diferente.
• Concilie un resultado incierto recuperando el pedido antes de iniciar un nuevo intento.

Ver Solicitudes idempotentes Para el período de retención de 24 horas, el comportamiento de retransmisión, los conflictos y las operaciones compatibles. Continuar. entrada completa del punto final, Autenticacióny Códigos de error.