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.