Pagamentos
Criar cobrança Multibanco 🇵🇹
POST /v1/payments com paymentMethods: ["MULTIBANCO"]. Multibanco é a rede de caixas
e homebanking de Portugal. A PagNow retorna uma URL de checkout hospedado
(cardRedirectUrl); você redireciona o cliente para lá, onde ele recebe a Entidade +
Referência para pagar em qualquer caixa Multibanco ou no homebanking. Moeda EUR.
Multibanco exige ativação prévia na sua conta (conta em EUR habilitada). Sem
ativação, a cobrança retorna 422 (NO_PROVIDER_CONFIGURED). Fale com
integrations@pagnow.com para habilitar.
cURL
curl -X POST 'https://v2.pagnow.com/v1/payments' \
-H 'apikey: pnk_sua_chave_aqui' \
-H 'content-type: application/json' \
-d '{
"amount": 12500,
"currency": "EUR",
"paymentMethods": ["MULTIBANCO"],
"idempotencyKey": "pedido-3311",
"customerName": "Rui Mendes",
"customerEmail": "rui@exemplo.com",
"metadata": { "orderId": "ORD-3311" },
"webhookUrl": "https://sua-loja.com/webhooks/pagnow"
}'Resposta (201)
{
"id": "e5f6a7b8-c9d0-4123-9ef0-123456789012",
"status": "WAITING_PAYMENT",
"amount": 12500,
"currency": "EUR",
"cardRedirectUrl": "https://checkout.v2.pagnow.com/c/e5f6a7b8...",
"createdAt": "2026-06-30T16:00:11.000Z"
}Redirecione o cliente para cardRedirectUrl. No checkout hospedado ele recebe a
Entidade, a Referência e o valor para pagar. A liquidação leva 1–3 dias úteis e chega
pelo webhook — o retorno do redirect não é confirmação de pagamento.
Campos principais
| Campo | Tipo | Obrigatório | Notas |
|---|---|---|---|
amount | int | sim | Centavos. 12500 = € 125,00. |
currency | string | sim | EUR. |
paymentMethods | string[] | sim | ["MULTIBANCO"]. |
idempotencyKey | string | sim | Reenvio retorna a cobrança original. |
customerName/Email | string | não | Pré-preenchem o checkout. |
webhookUrl | string | não | Recebe o POST de mudança de status. |
Campos da cobrança
| Campo | Notas |
|---|---|
cardRedirectUrl | URL do checkout hospedado. Redirecione o cliente para cá. |