AceitoFiado API

Integre "Pagar com AceitoFiado" no seu marketplace. 3 endpoints, autenticação Bearer, retorno via webhook. Pt-BR. ZDR.

autenticação

Todo request usa header Authorization: Bearer <sua-chave>. Chaves emitidas após cadastro em /cadastro.

endpoints

POST/api/v1/checkout

Cria uma sessão de checkout fiado.

request

{
  "amount": 18900,
  "items": [{ "name": "Turbante", "qty": 1, "priceCents": 18900 }],
  "prazo": 30,
  "supplierId": "<seu-id>",
  "marketplaceId": "feirapreta",
  "entrepreneurCpf": "13245678990",
  "successUrl": "https://loja.com/ok",
  "cancelUrl": "https://loja.com/cancel",
  "webhookUrl": "https://loja.com/api/webhook"
}

response 200

{
  "code": "AFXK-Q9M2-CX1Z",
  "payUrl": "https://aceitofiado.com/pay/AFXK-Q9M2-CX1Z",
  "expiresAt": "2026-05-24T15:30:00Z",
  "status": "PENDING"
}

GET/api/v1/checkout/{code}

Consulta status e dados de uma sessão. Público (qualquer um com o code).

response 200

{
  "code": "AFXK-Q9M2-CX1Z",
  "status": "PENDING",
  "amount": 18900,
  "feeCents": 945,
  "totalCents": 19845,
  "prazo": 30,
  "items": [...],
  "supplier": { "businessName": "Atelier Aruanda", ... }
}

POST/api/v1/checkout/{code}/confirm

Confirma fiado. Requer MEI logada (cookie httpOnly).

response 200

{
  "orderId": "ord_...",
  "status": "CONFIRMED",
  "dueDate": "2026-06-23T...",
  "totalCents": 19845,
  "successUrl": "https://loja.com/ok"
}

webhook

Quando MEI confirma, fazemos POST {webhookUrl} com payload:

{
  "code": "AFXK-Q9M2-CX1Z",
  "status": "CONFIRMED",
  "amount": 18900,
  "orderId": "ord_...",
  "confirmedAt": "2026-05-24T15:32:00Z"
}