Realizar una compra de prueba con Yape
Para probar tu integración con Yape deberás crear una order de prueba utilizando uno de los números de celular y el código OTP (One-Time Password) indicados a continuación, que simulan distintos escenarios de pago sin generar un cobro real. Esto significa que solo será posible verificar el funcionamiento de tu integración a través de una solicitud, y no simulando una compra.
Como un pago con Yape se procesa de forma síncrona cuando la order se crea en modo automático, el resultado de la prueba se devuelve en la propia respuesta a la creación de la order. Para eso, sigue los pasos a continuación.
El resultado del pago de prueba está controlado por el número de celular, ya sea para generar el token de prueba o crear la order de prueba. Utiliza los datos a continuación para simular cada escenario.
| Número de celular | Código OTP (One-Time Password) | status | status_detail |
| 111111111 | 123456 | processed | accredited |
| 111111112 | 123456 | failed | required_call_for_authorize |
| 111111113 | 123456 | failed | insufficient_amount |
| 111111114 | 123456 | failed | processing_error |
| 111111115 | 123456 | failed | invalid_card_token |
| 111111116 | 123456 | failed | max_attempts_exceeded |
| 111111117 | 123456 | failed | bad_filled_card_data |
| 111111118 | 123456 | failed | bad_filled_card_data |
Los procedimientos para crear el token y enviar el pago son los mismos que en la integración real, descritos en Yape. La única diferencia es el uso de los datos de la tabla anterior en lugar de los datos reales del pagador.
Para crear el token de prueba, envía una solicitud con tu Public Key de pruebaClave pública vinculada a una aplicación, utilizada en el frontend para inicializar y probar la integración. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales.Ver credenciales de prueba, uno de los números de celular de prueba (phoneNumber), el código OTP de prueba (otp) y un identificador único (requestId) al endpoint /platforms/pci/yape/v1/paymentPOST.
curlcurl --location --request POST 'https://api.mercadopago.com/platforms/pci/yape/v1/payment?public_key={{YOUR_PUBLIC_KEY}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "phoneNumber": "111111111", "otp": "123456", "requestId": "aaaaaaaa-bbbb-1ccc-8ddd-eeeeeeeeeeee" }'
En caso de éxito, recibirás una respuesta con los datos del token generado.
json{ "live_mode": true, "luhn_validation": null, "require_esc": null, "cloned": false, "cardholder": { "identification": { "number": null, "type": null, "subtype": null }, "name": "yape" }, "security_code_id": 8069792005119486812, "security_code_length": 6, "card_number_length": 9, "expiration_month": 8, "expiration_year": 2026, "card_present_id": null, "card_id": null, "client_id": 7775327892346559, "present": null, "id": "45d013f72bf42717a1625f4c508fc20f", "card_number_id": "FFTSHQTOSJTXGFVFGJKCBAIVOUISTFZBDRTQWLYJ", "creation_date": null, "due_date": null, "last_modified_date": null, "product_id": null, "trust_level": "unknown", "public_key": "YOUR_PUBLIC_KEY", "site_id": "MPE", "status": "active", "transaction_id": null, "trunc_card_number": null, "used_date": null, "bin": "111111", "version": 0, "client_header": null, "first_six_digits": "111111", "last_four_digits": "1111" }
El id devuelto en la respuesta es el token de prueba que debe enviarse a tu servidor para crear la order de prueba.
Con el token creado a partir de los datos de prueba, envía una solicitud al endpoint /v1/ordersPOST, juntamente con tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales y nunca debe exponerse en el frontend.Ver credenciales de prueba.
curlcurl --location --request POST 'https://api.mercadopago.com/v1/orders' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Content-Type: application/json' \ -d '{ "type": "online", "external_reference": "ext_ref_1234", "processing_mode": "automatic", "total_amount": "100.00", "payer": { "email": "test_payer@example.com", "entity_type": "individual", "identification": { "type": "DNI", "number": "12345678" }, "phone": { "area_code": "51", "number": "111111111" } }, "transactions": { "payments": [ { "amount": "100.00", "payment_method": { "id": "yape", "type": "debit_card", "token": "45d013f72bf42717a1625f4c508fc20f" } } ] } }'
Al utilizar el número de celular 111111111, la respuesta devolverá el status processed con status_detail=accredited, indicando que el pago de prueba fue aprobado.
json{ "id": "ORDPE01EXAMPLEPE1234NCAKKBF68N64S", "total_amount": "100.00", "total_paid_amount": "100.00", "country_code": "PER", "currency": "PEN", "status": "processed", "status_detail": "accredited", "transactions": { "payments": [ { "id": "PAYPE01EXAMPLEPE1234BSAR5ZWXX5YZG", "amount": "100.00", "paid_amount": "100.00", "status": "processed", "status_detail": "accredited", "payment_method": { "id": "yape", "type": "debit_card" } } ] } }
Para los demás números de celular de la tabla, la respuesta devolverá status=failed con el status_detail correspondiente al escenario simulado.
Por último, para verificar si la compra de prueba se realizó correctamente, envía una solicitud al endpoint /v1/orders/{id}GET, sustituyendo id por la identificación de la order, recibida en la respuesta a su creación.
Como alternativa, puedes consultar el resultado del pago desde tu aplicación. Para hacerlo, dirígete a Integraciones y selecciona la card de la aplicación. Asegúrate de que el selector del margen superior tenga seleccionado Prueba y, en la pantalla Inicio, selecciona la pestaña Pagos de prueba. Luego, busca el pago realizado y haz clic sobre él para consultar sus detalles y estado.
¡Listo! Una vez finalizados estos pasos, la integración de Yape como medio de pago estará completa y podrás, o bien continuar probando otros medios de pago integrados, o bien salir a producción.