Etapa 3: Crear un formToken
Objetivo
- Generar un formToken.
El formToken
es una clave generada por la plataforma de pago. Define el contexto del pago (monto, divisa, número de pedido, datos del comprador, etc.).
El formToken
es el resultado de la respuesta de la llamada al Web Service REST Charge/CreatePayment. El formToken es válido durante 15 minutos.
I. Solicitud de pago simple
Ejemplo: .
- montant : S/ 1,80.
- pedido: "myOrderId-999999"
- e-mail del comprador: "sample@example.com ".
/doc/es-PE/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.micuentaweb.pe/api-payment/V4/Charge/CreatePayment
{ "amount": 180, "currency": "PEN", "orderId": "myOrderId-999999", "customer": { "email": "sample@example.com" } }
{ "amount": 1500, "currency": "PEN", "orderId": "myOrderId-999999", "more": "parameters", "customer": { "email": "sample@example.com" } }
{ "amount": 20000, "currency": "ARS", "orderId": "myOrderId-999999", "more": "parameters", "customer": { "email": "sample@example.com" } }
{ "amount": 100000, "currency": "COP", "orderId": "myOrderId-999999", "more": "parameters", "customer": { "email": "sample@example.com" } }
{ "amount": 2500, "currency": "BRL", "orderId": "myOrderId-999999", "more": "parameters", "customer": { "email": "sample@example.com" } }
II. Respuesta para un pago simple
{ "status": "SUCCESS", "_type": "V4/WebService/Response", "webService": "Charge/CreatePayment", "applicationProvider": "MCW", "version": "V4", "applicationVersion": "4.1.0", "answer": { "formToken": "DEMO-TOKEN-TO-BE-REPLACED", "_type": "V4/Charge/PaymentForm" } }
III. Otros casos de uso
En esta página se encuentran otros ejemplos: Casos de uso.
IV. Utilización del Playground
Utilice el Playground Charge/CreatePayment para ver todos los campos disponibles.
Haga clic en el botón "Pruébeme", cree su solicitud y ejecute la llamada REST para generar el formToken.
V. Ejemplo simplificado de PHP
En la carpeta sample
, el archivo para esta etapa es formToken.php.
Para más información, Archivo de ejemplo: formToken.php.