Realizar compra de teste com Yape
Para testar sua integração com Yape você deverá criar uma order de teste utilizando um dos números de celular e o código OTP (One-Time Password) indicados abaixo, que simulam diferentes cenários de pagamento sem gerar uma cobrança real. Isso significa que só será possível verificar o funcionamento da sua integração por meio de uma requisição, e não simulando uma compra.
Como um pagamento com Yape é processado de forma síncrona quando a order é criada em modo automático, o resultado do teste é devolvido na própria resposta à criação da order. Para isso, siga as etapas abaixo.
O resultado do pagamento de teste é controlado pelo número de celular, seja para gerar o token de teste ou criar a order de teste. Utilize os dados abaixo para simular cada cenário.
| 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 |
Os procedimentos para criar o token e enviar o pagamento são os mesmos da integração real, descritos em Yape. A única diferença é o uso dos dados da tabela acima no lugar dos dados reais do pagador.
Para criar o token de teste, envie uma requisição com sua Public Key de testeChave pública vinculada a uma aplicação, utilizada no frontend para inicializar e testar a integração. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais.Ver credenciais de teste, um dos números de celular de teste (phoneNumber), o código OTP de teste (otp) e um identificador único (requestId) ao 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" }'
Em caso de sucesso, você receberá uma resposta com os dados do token gerado.
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" }
O id retornado na resposta é o token de teste que deve ser enviado ao seu servidor para criar a order de teste.
Com o token criado a partir dos dados de teste, envie uma solicitação ao endpoint /v1/ordersPOST, juntamente com seu Access Token de testeChave privada vinculada a uma aplicação, utilizada no backend para autenticar operações no ambiente de teste. Você pode consultá-la na seção Credenciais da aplicação, dentro do ambiente de teste. Ela não permite processar pagamentos reais e nunca deve ser exposta no frontend.Ver credenciais de teste.
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" } } ] } }'
Ao utilizar o número de celular 111111111, a resposta retornará o status processed com status_detail=accredited, indicando que o pagamento de teste foi aprovado.
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 os demais números de celular da tabela, a resposta retornará status=failed com o status_detail correspondente ao cenário simulado.
Por fim, para verificar se a compra de teste foi realizada corretamente, envie uma requisição ao endpoint /v1/orders/{id}GET, substituindo id pela identificação da order, recebida na resposta à sua criação.
Como alternativa, você pode consultar o resultado do pagamento na sua aplicação. Para isso, acesse Integrações e selecione o card da aplicação. Certifique-se de que o seletor na parte superior esteja em Teste e, na tela Início, selecione a aba Pagamentos de teste. Depois, localize o pagamento realizado e clique nele para consultar os detalhes e o status.
Pronto! Uma vez finalizadas estas etapas, a integração de Yape como meio de pagamento estará completa e você poderá, ou continuar testando outros meios de pagamento integrados, ou subir em produção.