Transbank Transacción Normal (Webpay)

Transbank en modo Webpay o Transacción Normal permite redirigir al cliente al sitio de Webpay, en el cual podrá introducir sus datos para realizar el pago, con la posibilidad de autenticarse con su banco.

Petición de inicio de cargo

Definición

POST /v1/{MERCHANT_ID}/charges

Ejemplo de petición de cargo

{
    "method": "card",
    "amount": "100000",
    "currency": "CLP",
    "description": "Charge with Transbank Webpay",
    "order_id": "1511307450",
    "request_payment_data" : true,
    "use_3d_secure" : true,
    "customer": {
        "name": "John",
        "last_name": "Doe",
        "phone_number": "1234567890",
        "email": "john.doe@example.com"
    },
    "redirect_url": "https://www.example.com/merchantEndpoint"
}

Ejemplo de respuesta de cargo

{
    "id": "trwhmguisixsng0rkr2l",
    "authorization": null,
    "operation_type": "in",
    "method": "card",
    "transaction_type": "charge",
    "status": "charge_pending",
    "conciliated": true,
    "creation_date": "2017-11-12T17:28:13-06:00",
    "operation_date": "2017-11-12T17:28:13-06:00",
    "description": "Charge with Transbank Webpay",
    "error_message": null,
    "order_id": "1511307450",
    "due_date": "2017-11-12T17:33:13-06:00",
    "amount": 100000,
    "customer": {
        "name": "John",
        "last_name": "Doe",
        "email": "john.doe@example.com",
        "phone_number": "1234567890",
        "address": null,
        "creation_date": "2017-11-12T17:28:12-06:00",
        "external_id": null,
        "clabe": null
    },
    "currency": "CLP",
    "payment_method": {
        "type": "redirect",
        "url": "https://api.openpay.mx/v1/mabc123def456ghi7890/charges/trwhmguisixsng0rkr2l/redirect/"
    }
}

Para iniciar un cargo con Transbank Transacción Normal no es necesario enviar los datos de tarjeta. Estos datos serán solicitados por Transbank, con la opción de autenticar al usuario, por lo que se debe enviar el parámetro request_payment_data con valor true, y el valor use_3d_secure con valor true. El campo redirect_url debe ser enviado con la URL a la que se redirigirá al cliente al terminar el proceso.

Es importante tomar en cuenta que el usuario solo contará con 5 minutos para terminar su pago una vez que se obtenga esta URL de Openpay. Una vez que el usuario sea redirigido a la URL indicada y complete su pago, se enviará una notificación al comercio con los detalles del pago, indicando si fue exitoso o no.

Openpay redirigirá al cliente al sitio indicado por el comercio, agregando un parámetro llamado id con el ID de la transacción. Es necesario que el comercio verifique la transacción en Openpay usando el API para confirmar si la transacción fue exitosa o no.