EDPay/ docs API v1.3.0
DocumentaçãoLinks de pagamento

Crie links de valor fixo e veja os limites do checkout hospedado.

Links de pagamento

GET/v1/payment-links

Lista até 100 links pertencentes à conta e ao ambiente da chave. Scope: payment_links:read. Retorna um array em data e o identificador em meta.request_id.

POST/v1/payment-links

Cria um registo de link com valor fixo. Scope: payment_links:write. Campos: amount_minor positivo, currency igual à moeda-base MZN, USD ou EUR da conta e expires_at opcional. O código é normalizado para maiúsculas; moeda diferente da moeda-base ou não suportada responde HTTP 422. O servidor gera o ID e a referência. A URL pública é construída como /pagar?link={id}. Envie Idempotency-Key.

curl -i -X POST \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: checkout-order-1042' \
  --data '{"amount_minor":10000,"currency":"MZN","expires_at":null}' \
  "https://api-pay.edutecka.com/v1/payment-links"
HTTP/1.1 201 Created
Content-Type: application/json

{
  "data": {
    "id": "plink_…",
    "reference": "ref_…",
    "amount_minor": 10000,
    "currency": "MZN",
    "status": "active",
    "expires_at": null,
    "created_at": "2026-01-01T10:00:00Z"
  },
  "meta": { "request_id": "req_…" }
}
GET/v1/payment-links/{id}

Consulta um link pertencente à conta e ao ambiente da chave. Scope: payment_links:read. Um recurso de outra conta ou ambiente responde como não encontrado.

GET/checkout/v1/payment-links/{id}

Rota pública usada pela página hospedada. Devolve comerciante, montante, moeda e ambiente; não devolve telefone nem aceita alterações. amount_minor é uma string para manter precisão no browser. Esta rota não usa API key e está fora do OpenAPI de parceiros.