Yape

Para receber pagamentos, adicione no frontend um formulário que capture o número de celular e o OTP que o comprador gera no aplicativo Yape.

Se você já tem um desenvolvimento que inclui um formulário de pagamento próprio, certifique-se de incluir Yape entre as opções de pagamento que deseja oferecer, conforme indicado abaixo, e continue para a etapa de Criar token Yape.

Caso ainda não tenha um formulário de pagamento, adicione o modelo abaixo ao seu projeto e inclua o identificador do Yape como opção a ser oferecida.

html
<form id="form-checkout" action="/process_payment" method="post">
  <div>
    <label for="payerPhone">Número de celular</label>
    <input id="form-checkout__payerPhone" name="payerPhone" type="text" />
  </div>
  <div>
    <label for="payerOTP">OTP</label>
    <input id="form-checkout__payerOTP" name="payerOTP" type="text" />
  </div>
  <div>
    <button type="submit">Pagar com Yape</button>
  </div>
</form>

O token Yape é criado a partir do número do celular e do código OTP (One-Time Password) informados na requisição, aumentando a segurança durante o fluxo de pagamento. Uma vez que o token é utilizado em determinada compra, ele é descartado, sendo necessária a criação de um novo para futuras compras.

Você pode criá-lo com o MercadoPago.js ou por uma chamada direta à API.

javascript
const form = document.getElementById("form-checkout");

form.addEventListener("submit", async (event) => {
  event.preventDefault();

  const otp = document.getElementById("form-checkout__payerOTP").value;
  const phoneNumber = document.getElementById("form-checkout__payerPhone").value;
  const yape = mp.yape({ otp, phoneNumber });
  const yapeToken = await yape.create();

  // Envie yapeToken.id ao seu servidor para criar a order.
});

O envio do pagamento deve ser realizado mediante a criação de uma order que contenha a transação de pagamento associada.

Para isso, envie uma requisição com o seu Access Token de testeChave privada da aplicação criada no Mercado Pago, utilizada no backend. Acesse-a em Suas integrações > Dados da integração > Testes > Credenciais de teste. O Access Token de teste começa com o prefixo `APP_USR`. e os parâmetros indicados abaixo ao endpoint /v1/ordersPOST.

curl
curl --location --request POST 'https://api.mercadopago.com/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \
--header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \
--data-raw '{
  "type": "online",
  "external_reference": "ext_ref_1234",
  "processing_mode": "automatic",
  "total_amount": "100.00",
  "payer": {
    "email": "test_user_pe@testuser.com",
    "entity_type": "individual",
    "identification": {
      "type": "DNI",
      "number": "12345678"
    },
    "phone": {
      "area_code": "51",
      "number": "987654321"
    }
  },
  "transactions": {
    "payments": [
      {
        "amount": "100.00",
        "payment_method": {
          "id": "yape",
          "type": "debit_card",
          "token": "{{YOUR_YAPE_TOKEN}}"
        }
      }
    ]
  }
}'

Veja na tabela abaixo as descrições dos parâmetros que são obrigatórios na requisição e daqueles que, embora sejam opcionais, possuem alguma particularidade importante de ser destacada.

Ao criar a order com sucesso, você receberá uma resposta com status: processed e status_detail: accredited, indicando que o pagamento foi aprovado.

json
{
  "id": "ORDPE01EXAMPLEPE1234NCAKKBF68N64S",
  "type": "online",
  "processing_mode": "automatic",
  "external_reference": "ext_ref_1234",
  "total_amount": "100.00",
  "total_paid_amount": "100.00",
  "country_code": "PER",
  "user_id": "1234567890",
  "status": "processed",
  "status_detail": "accredited",
  "capture_mode": "automatic_async",
  "currency": "PEN",
  "created_date": "2026-07-29T21:03:42.252Z",
  "last_updated_date": "2026-07-29T21:03:43.985Z",
  "integration_data": {
    "application_id": "1234567890123456"
  },
  "transactions": {
    "payments": [
      {
        "id": "PAYPE01EXAMPLEPE1234BSAR5ZWXX5YZG",
        "reference_id": "1234567890",
        "amount": "100.00",
        "paid_amount": "100.00",
        "status": "processed",
        "status_detail": "accredited",
        "payment_method": {
          "id": "yape",
          "type": "debit_card"
        }
      }
    ]
  }
}

Como o Yape é processado de forma síncrona quando a order é criada em modo automático, não há redirecionamento do comprador. Entre os parâmetros devolvidos, destacam-se os indicados na tabela a seguir.

O modo escolhido na criação da order (automático ou manual) determina como o pagamento com Yape é processado e, consequentemente, como seu cancelamento deve ser realizado. Veja a seguir o procedimento correspondente a cada situação:

• Modo automático: a order é criada em modo automático e o pagamento com Yape é processado de forma síncrona (status=processed). Com isso, a resposta à criação da order já trará o resultado final do pagamento, não sendo possível cancelá-lo quando aprovado (status_detail=accredited). Nesse caso, será necessário realizar um processo de reembolso através de uma solicitação ao endpoint de /v1/orders/{order_id}/refundPOST.
  
  
• Modo manual: a order é criada em modo manual e o processamento do pagamento requer uma etapa adicional (status=action_required) no endpoint de Processar orderPOST. Nesse caso, antes de processar o pagamento será possível cancelá-lo através de uma solicitação ao endpoint de /v1/orders/{order_id}/cancelPOST.

Para obter mais informações, consulte a seção Reembolsos e cancelamentos.