Validar OTP

POST https://payment-backend-sandbox.milio.com.co/payment-agreements/validate-otp/:code

Valida el acuerdo de pago utilizando el OTP enviado al tercero. Este endpoint es clave para confirmar que el tercero autoriza la operación de cobro recurrente. Al enviar el código OTP, el sistema verifica si el tercero ya cuenta con métodos de pago registrados. En caso afirmativo, se permite seleccionar uno de los métodos existentes para validar el acuerdo. Si, por el contrario, el tercero no dispone de ningún método registrado, se habilita la opción de registrar uno nuevo durante la misma operación, utilizando igualmente el OTP para confirmar la acción. De esta forma, se asegura la autenticidad de la transacción y se adapta el proceso a la situación específica del tercero, garantizando tanto la seguridad como la flexibilidad en la validación del acuerdo.

Parámetros de Entrada:

code (number): Código OTP enviado al tercero.

Cuerpo de Entrada:

• Con método existente:
  • thirdBankUUID (string) Identificador del método de pago del tercero.
• Para agregar una tarjeta:
  • cardNumber: Número de tarjeta del tercero.
  • cardExpiryDate: Fecha de expiración de la tarjeta.
  • cardCVV: Código CVV o CVC de la tarjeta.
  • cardName: Nombre que figura en la tarjeta.

Respuesta método existente

JSON

{
    "error": 0,
    "code": "ML000",
    "category": "GENERAL",
    "message": "Código OTP validado",
    "data": {
        "id": "...",
        "urlContract": "..."
    }
}

Respuesta nueva tarjeta

JSON

{
    "error": 0,
    "code": "ML000",
    "category": "GENERAL",
    "message": "Código OTP validado",
    "data": {
        "id": "...",
        "urlContract": "...",
      	"thirdBankUUID": "..."
    }
}