Primeiros passos

Da conta criada à primeira verificação, em quatro passos.

1. Criar a loja

Crie a conta em payapp.ferreirakorp.com/comecar ou pela API, com POST /v1/register. É preciso pelo menos um IBAN ou um número Multicaixa Express: é para essas contas que o PayApp confirma o destino das transferências.

Guarde a chave

a api_key só é mostrada uma vez, no fim do registo.

2. Autenticar

Envie a chave em todos os pedidos, num destes cabeçalhos:

X-API-Key: pk_live_…
Authorization: Bearer pk_live_…

3. Verificar o primeiro comprovativo

Envie o PDF emitido pelo banco:

curl -X POST https://api.payapp.ferreirakorp.com/v1/verify \
  -H "X-API-Key: pk_live_…" \
  -F "[email protected]"

A resposta e todos os campos estão em Verificar um comprovativo.

4. Decidir

Só entregue a mercadoria quando autentico for true e repetido for false. Quando falha, o campo motivo traz explicações em português que pode mostrar ao cliente.

Para ser avisado sem ter de perguntar, configure um webhook.