Criar cobrança LATAM e África 🌎

POST /v1/payments com paymentMethods: ["CREDIT_CARD"] e o country do pagador. A PagNow retorna uma URL de checkout hospedado (cardRedirectUrl) onde o cliente escolhe o método local do país dele — cartão, transferência bancária, dinheiro ou carteira móvel — e volta para a sua loja.

Não existe um valor de paymentMethods por método local (não envie "PSE" ou "NEQUI"): quem apresenta as opções é a página de checkout, com base no country. O roteamento usa country + currency; veja Campos avançados.

Brasil não usa este fluxo. Cobranças em BRL têm trilha própria — veja Criar cobrança PIX e Boleto.

cURL

curl -X POST 'https://v2.pagnow.com/v1/payments' \
  -H 'apikey: pnk_sua_chave_aqui' \
  -H 'content-type: application/json' \
  -d '{
    "amount": 25000,
    "currency": "MXN",
    "country": "MX",
    "paymentMethods": ["CREDIT_CARD"],
    "idempotencyKey": "pedido-7700",
    "customerName": "Sofía Ramírez",
    "customerEmail": "sofia@exemplo.com",
    "metadata": { "orderId": "ORD-7700" },
    "webhookUrl": "https://sua-loja.com/webhooks/pagnow"
  }'

Resposta (201)

{
  "id": "b2c3d4e5-f6a7-4890-b123-456789abcdef",
  "status": "WAITING_PAYMENT",
  "amount": 25000,
  "currency": "MXN",
  "cardRedirectUrl": "https://checkout.v2.pagnow.com/c/b2c3d4e5...",
  "createdAt": "2026-07-16T12:00:00.000Z"
}

Redirecione o cliente para cardRedirectUrl. Confirme a aprovação pelo webhook — o retorno do redirect não é confirmação de pagamento.

Campos principais

Campo	Tipo	Obrigatório	Notas
`amount`	int	sim	Centavos. `25000` = MX$ 250,00.
`currency`	string	sim	Moeda local do país (veja a tabela) ou `USD`, aceito em todos.
`country`	string	sim	ISO 3166-1 alpha-2 do pagador. Define quais métodos aparecem no checkout.
`paymentMethods`	string[]	sim	`["CREDIT_CARD"]`.
`idempotencyKey`	string	sim	Reenvio retorna a cobrança original.
`customerName`, `customerEmail`	string	recomendado	Podem ser exigidos pelo método local escolhido.
`webhookUrl`	string	não	Recebe o `POST` de mudança de status.

Países e moedas

Todos aceitam USD além da moeda local.

País	`country`	Moeda local
Argentina 🇦🇷	`AR`	`ARS`
Chile 🇨🇱	`CL`	`CLP`
Colômbia 🇨🇴	`CO`	`COP`
Costa Rica 🇨🇷	`CR`	`CRC`
Equador 🇪🇨	`EC`	`USD`
El Salvador 🇸🇻	`SV`	`USD`
Guatemala 🇬🇹	`GT`	`GTQ`
México 🇲🇽	`MX`	`MXN`
Panamá 🇵🇦	`PA`	`USD`
Peru 🇵🇪	`PE`	`PEN`
Burkina Faso 🇧🇫	`BF`	`XOF`
Camarões 🇨🇲	`CM`	`XAF`
Costa do Marfim 🇨🇮	`CI`	`XOF`
Gana 🇬🇭	`GH`	`GHS`
Nigéria 🇳🇬	`NG`	`NGN`
Quênia 🇰🇪	`KE`	`KES`
Ruanda 🇷🇼	`RW`	`RWF`
Senegal 🇸🇳	`SN`	`XOF`
África do Sul 🇿🇦	`ZA`	`ZAR`
Tanzânia 🇹🇿	`TZ`	`TZS`
Uganda 🇺🇬	`UG`	`UGX`
Zâmbia 🇿🇲	`ZM`	`USD`

Campos da cobrança

Campo	Notas
`cardRedirectUrl`	URL do checkout hospedado. Redirecione o cliente para cá.