• Francia
Back Office Vendedor
asistencia
FAQcontacte el soporte tecnico
Buscar
Categoria
Tags
Perú
Perú
Página principal
Casos de uso
Crear un pago
Crear un pago en cuotas
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
API REST PCI-DSS
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Módulos de pago
Guías
Back Office Vendedor
Guías funcionales

Etapa 3: Crear el 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"
    }
}

El formToken generado es Processing...

III. Otros casos de uso

  • Enviar los datos del subvendedor

  • Modificar el monto en función del código BIN

  • Seleccionar los medios de pago

  • Ofrecer el registro del medio de pago.

  • Aumentar la probabilidad de frictionless en 3DS2

  • Transmitir datos personalizados

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.

SIGUIENTE PASO N°4

© 2025 Todos los derechos reservados de Izipay
25.17-1.11