Inicio de una sesión
El primer paso de una transacción Hosted Checkout es enviar una solicitud de API al Mastercard Gateway usando la operación INITIATE CHECKOUT. La solicitud crea una sesión de pago en el motor de pagos y debe incluir:
- Detalles relacionados con la transacción PAY, AUTHORIZE o VERIFY que desea crear.
- Información sobre cómo debe interactuar el Hosted Payment Page con el pagador.
- Instrucciones para completar el proceso Hosted Payment Page.
- Para conocer todos los parámetros y campos del cuerpo de la solicitud admitidos para la solicitud, consulte Initiate Checkout.
- Para API v62 y versiones anteriores, utilice la operación CREATE CHECKOUT SESSION en lugar de Initiate Checkout.
El siguiente ejemplo muestra un fragmento de código cURL para la solicitud INITIATE CHECKOUT.
| URL | curl --location htt/rest/version/72/merchant/<merchant_ID>/session'\ |
--header 'Content-Type: text/plain' \
--header 'Authorization: Basic <base64-encoded string of "merchant.<merchant ID>:<password>"' \
--data ' {
"apiOperation": "INITIATE_CHECKOUT",
"interaction":{
"operation" :"AUTHORIZE",
"merchant": {
"name": "<merchant_name>"
}
},
"order": {
"currency":"USD",
"amount": "100.00",
"id" : "<order_ID>",
"description": "<description_of_order>"
}
}
'
Una respuesta INITIATE CHECKOUT exitosa contiene los campos session.id y successIndicator. Compruebe el valor del campo successIndicator para verificar el éxito o fracaso del pago. Para obtener más información, consulte Obtención del resultado del pago.