Pular para o conteúdo principal
Use method: "voucher" quando o cliente vai pagar fora do fluxo de cartão ou Pix por meio de uma instrução local, referência bancária, redirecionamento ou documento pagável. voucher é o método público da Pagou. O meio de pagamento local real é escolhido pela configuração de pagamento da empresa, moeda e país. Não envie nomes específicos de provedor como boleto, spei, mercadopago, webpay ou codi para a API de transações.

​
Significado por país

Mercado do clienteMeio de pagamento comum por trás de voucherO que o cliente recebe
Brasil, BRLBoletoCódigo de barras, linha digitável, vencimento e URL do boleto quando disponível.
México, MXNSPEI ou transferência bancária localCLABE/conta, referência, URL de pagamento ou instruções de transferência.
Argentina, ARSVoucher local de caixa ou carteira, como Mercado Pago quando habilitado para a empresaReferência, URL de redirecionamento ou instruções locais de pagamento.
Chile, CLPWebpay ou voucher localURL de redirecionamento/pagamento ou instruções de pagamento.
Colômbia, COPPSE ou voucher localURL de redirecionamento/pagamento ou instruções de pagamento.
Peru, PENVoucher local ou transferência bancáriaReferência, URL de pagamento ou instruções de pagamento.
A disponibilidade depende da configuração do seller e do provedor de pagamento habilitado para a empresa. Se a empresa não tiver o país/moeda habilitado, a criação do pagamento será recusada.

​
Criar a transação

Crie um pagamento por voucher com POST /v2/transactions. 
{
  "external_ref": "order_3001",
  "amount": 125000,
  "currency": "MXN",
  "method": "voucher",
  "buyer": {
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "document": {
      "type": "CURP",
      "number": "LOLA800101MDFXXX09"
    },
    "address": {
      "street": "Av. Paseo de la Reforma",
      "city": "Cidade do Mexico",
      "zipCode": "06600",
      "country": "MX"
    }
  },
  "products": [
    {
      "name": "Plano anual",
      "price": 125000,
      "quantity": 1
    }
  ],
  "notify_url": "https://example.com/webhooks/pagou"
}
amount e price dos produtos usam a menor unidade da moeda escolhida. Para BRL e MXN, envie centavos. Em pagamentos LATAM por voucher, envie buyer.document e buyer.address.country sempre que possível. Algumas configurações SPEI conseguem criar o pagamento sem documento, mas a maioria dos meios por voucher/transferência valida o tipo de documento para o país selecionado. Não inclua token. Tokens de cartão só são válidos para method: "credit_card".

​
Tipos de documento aceitos

Use estes valores em buyer.document.type quando o comprador pagar com method: "voucher". O país é lido de buyer.address.country quando esse campo é enviado; caso contrário, a Pagou pode inferir um país principal a partir de currency.
PaísCódigo do paísTipos de documento aceitos
ArgentinaARDNI, CUIT
BolíviaBOCI, CE, NIT
BrasilBRCPF, CNPJ
ChileCLRUT, RUN
ColômbiaCOCC, NIT
Costa RicaCRCDI
EquadorECCI, PP, RUC, PAS
GuatemalaGTDPI, CUI, NIT
MéxicoMXRFC, CURP
PanamáPACE
ParaguaiPYCI, RUC
PeruPEDNI, RUC
UruguaiUYCI, RUC
Esta tabela lista os tipos de documento aceitos pela validação da API. A disponibilidade de pagamento em cada país ainda depende da configuração de pagamento habilitada para a empresa.

​
Exibir as instruções

A resposta da transação expõe o objeto normalizado voucher. 
{
  "id": "tr_3001",
  "status": "pending",
  "method": "voucher",
  "amount": 125000,
  "currency": "MXN",
  "voucher": {
    "barcode": "646180123456789012",
    "digitable_line": "646180123456789012",
    "url": "https://provider.example/pay/order_3001",
    "expiration_date": "2026-05-12T23:59:59.000Z",
    "instructions": "Pague usando a referência bancária antes do vencimento.",
    "receipt_url": null
  }
}
CampoSignificado
voucher.barcodeCódigo de barras, conta bancária, CLABE, código de pagamento ou referência do provedor, conforme o meio de pagamento local.
voucher.digitable_lineLinha digitável, referência de transferência, CLABE ou instrução equivalente para o cliente copiar.
voucher.urlPágina de pagamento, URL do boleto, URL de redirecionamento, imagem de QR code ou voucher hospedado no provedor. Use como chamada principal quando existir.
voucher.expiration_dateVencimento ou data de expiração da instrução de pagamento.
voucher.instructionsInstruções adicionais do banco, provedor ou meio de pagamento.
voucher.receipt_urlURL de comprovante quando o provedor retorna esse dado. Normalmente aparece depois da confirmação do pagamento.
Os campos são nullable porque cada país e provedor de pagamento retorna um formato diferente de instrução. Monte o checkout para exibir todos os campos presentes, e não para depender de um formato fixo de Boleto.

​
Atualizações assíncronas

Alguns provedores retornam todos os dados de voucher na resposta de criação. Outros retornam primeiro status: "pending" e entregam os campos de voucher por webhook logo depois. Use esta sequência:
  1. Crie a transação com method: "voucher".
  2. Se voucher.url, voucher.digitable_line ou voucher.barcode vier preenchido, exiba imediatamente.
  3. Assine webhooks de pagamento e atualize a página do cliente quando a mesma transação receber as instruções de voucher.
  4. Reconcilie com GET /v2/transactions/{id} se o worker perder um webhook ou se o cliente atualizar o checkout.
Meios de voucher com redirecionamento, como Webpay ou CODI, continuam sendo pagamentos voucher. Trate a URL como a ação de pagamento do voucher, não como um desafio 3DS de cartão.

​
Endpoints relevantes

EndpointUso
POST /v2/transactionsCriar a transação voucher.
GET /v2/transactions/{id}Consultar o status e os campos de voucher mais recentes.
GET /v2/transactions?paymentMethods=voucherListar transações voucher para reconciliação ou operação.
PUT /v2/transactions/{id}/refundSolicitar reembolso depois da confirmação de pagamento, quando o provedor e o meio de pagamento escolhido suportarem reembolso.
Webhooks de pagamentoReceber eventos transaction.pending, transaction.paid, reembolso, expiração e chargeback.

​
Leia a seguir