Bem-vindo à A4therPay
Gateway de pagamentos brasileiro com API REST para PIX, webhooks com retry automático e SDKs em sete linguagens.
O que é a A4therPay #
A4therPay é uma camada de pagamentos sobre PIX. Você cria uma cobrança pela nossa API, e nós cuidamos do resto: geração do PIX, conciliação, webhooks com retry, saques e transferências entre contas A4therPay.
- API REST com SDKs em sete linguagens, tipagem completa e erros estruturados.
- Webhooks com retry e assinatura HMAC SHA-256, em produção e sandbox.
- Sandbox completo sem precisar de cartão. Use chaves
a4ther_test_*. - Saques e transferências PIX direto pela API, com escopos por chave.
Hoje a A4therPay processa PIX.
Cartão e boleto estão no roadmap, ainda sem data. A documentação abaixo cobre apenas o que a API faz hoje.
Base URL
# Producao e sandbox usam o mesmo host. O modo vem do prefixo da chave. https://a4therpay-api.discloud.app/api/v1
Quickstart #
O cadastro do lojista é feito no site a4therpay.com; não há endpoint de API para isso. Depois de criar a conta, gere uma chave de teste no painel da A4therPay. As chaves a4ther_test_* são gratuitas e ilimitadas.
1. Instale o SDK
npm install a4therpay
pip install a4therpay
go get github.com/a4therpay/a4therpay-go
composer require a4therpay/a4therpay
2. Crie a primeira cobrança
# Cria uma cobranca PIX de R$ 49,90 curl -X POST https://a4therpay-api.discloud.app/api/v1/charges/ \ -H "Authorization: Bearer a4ther_test_xxx" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "amount_cents": 4990, "description": "Pedido 1042", "customer": { "name": "Ana Lima", "email": "ana@empresa.com" } }'
import { A4therPay } from "a4therpay"; const a4therpay = new A4therPay({ apiKey: process.env.A4THERPAY_API_KEY }); const charge = await a4therpay.charges.create({ amount_cents: 4990, description: "Pedido 1042", customer: { name: "Ana Lima", email: "ana@empresa.com" }, }, { idempotencyKey: crypto.randomUUID() }); console.log(charge.pix_copy_paste);
from a4therpay import A4therPay client = A4therPay("a4ther_test_xxx") charge = client.charges.create({ "amount_cents": 4990, "description": "Pedido 1042", "customer": {"name": "Ana Lima", "email": "ana@empresa.com"}, }, idempotency_key=str(uuid.uuid4())) print(charge.pix_copy_paste)
package main import "github.com/a4therpay/a4therpay-go" func main() { client := a4therpay.New(a4therpay.Config{ APIKey: os.Getenv("A4THERPAY_API_KEY") }) charge, _ := client.Charges.Create(&a4therpay.ChargeParams{ AmountCents: 4990, Description: "Pedido 1042", Customer: &a4therpay.Customer{Name: "Ana Lima", Email: "ana@empresa.com"}, IdempotencyKey: uuid.NewString(), }) fmt.Println(*charge.PixCopyPaste) }
use A4therPay\A4therPay; $a4therpay = new A4therPay(["api_key" => getenv("A4THERPAY_API_KEY")]); $charge = $a4therpay->charges->create([ "amount_cents" => 4990, "description" => "Pedido 1042", "customer" => ["name" => "Ana Lima", "email" => "ana@empresa.com"], ], ["idempotency_key" => bin2hex(random_bytes(16))]); echo $charge->pix_copy_paste;
3. Resposta
{ "id": "chg_test_aB3kfP9XmZ8s2nQwRtY7", "merchant_id": "01HXY2Z3...", "status": "pending", "amount_cents": 4990, "currency": "BRL", "payment_method": "pix", "pix_copy_paste": "00020126...", "pix_qr_code": "data:image/png;base64,iVBORw0KGgo...", "fee_processor_cents": 49, "fee_platform_cents": 35, "net_amount_cents": 4906, "customer": { "name": "Ana Lima", "email": "ana@empresa.com" }, "metadata": {}, "expires_at": "2026-06-08T19:42:18+00:00", "created_at": "2026-06-08T19:27:18+00:00", "updated_at": "2026-06-08T19:27:18+00:00" }
Pronto. O webhook charge.paid chega logo em seguida.
No sandbox, qualquer valor (exceto magic values) é aprovado em poucos segundos. Configure o endpoint que recebe os webhooks no painel da A4therPay.
Autenticação #
Toda chamada server-to-server usa API Keys via header Authorization: Bearer a4ther_(test|live)_xxx. O modo é derivado automaticamente do prefixo:
| Prefixo | Modo | Comportamento |
|---|---|---|
a4ther_test_ | Sandbox | Nenhuma transação real, dados isolados em cache com TTL 30 dias. |
a4ther_live_ | Produção | Cobra de verdade. Liquidação imediata via PIX. |
A API Key é criada no painel da A4therPay; não há endpoint público para gerá-la. O cadastro e o login do lojista também ficam no painel e usam JWT, fora do escopo desta referência de integração.
Nunca exponha chaves no front-end.
Cada chave carrega apenas os escopos que você atribuiu (veja Escopos). Use sempre no servidor (server-to-server).
Escopos
Toda chamada com API Key valida os escopos da chave contra o escopo exigido pelo endpoint. Sem o escopo, a resposta é 403 com API_KEY_INSUFFICIENT_SCOPE. Atribua só o necessário a cada chave.
| Escopo | Permite |
|---|---|
payments.create | Criar cobranças PIX (POST /charges/) |
payments.read | Listar e consultar cobranças (GET /charges/, GET /charges/{id}) |
withdrawals.create | Criar saques e transferências internas (POST /withdrawals/, POST /internal-transfers/) |
withdrawals.read | Listar e consultar saques (GET /withdrawals/, GET /withdrawals/{id}) |
transfers.read | Listar e consultar transferências internas (GET /internal-transfers/, GET /internal-transfers/{id}) |
O extrato (GET /transactions/) aceita qualquer um entre payments.read, transfers.read ou withdrawals.read.
Sandbox #
Use chaves a4ther_test_* para simular pagamentos sem cobrar ninguém. O sandbox dispara webhooks reais com a mesma assinatura HMAC SHA-256 da produção.
Magic values
O amount_cents determina o resultado simulado da cobrança. Os valores exatos são publicados pela API pública (abaixo); use sempre a resposta dela como verdade:
| Valor | Em R$ | Resultado |
|---|---|---|
1 | R$ 0,01 | cobrança fica paid |
2 | R$ 0,02 | cobrança fica expired |
3 | R$ 0,03 | cobrança fica refunded |
| qualquer outro | - | cobrança fica paid |
Lista atualizada em tempo real via API pública:
curl https://a4therpay-api.discloud.app/api/v1/test/scenarios
Resetar dados sandbox
Apaga todos os charges de teste do merchant atual:
curl -X POST https://a4therpay-api.discloud.app/api/v1/test/reset \
-H "Authorization: Bearer a4ther_test_xxx"
Saques e transferências não têm sandbox.
Os endpoints /withdrawals/ e /internal-transfers/ (e o extrato /transactions/) recusam chaves a4ther_test_ com 403 SANDBOX_NOT_SUPPORTED_FOR_WITHDRAWALS / SANDBOX_NOT_SUPPORTED_FOR_TRANSFERS. Teste-os apenas com chave a4ther_live_.
Idempotência #
Os endpoints de escrita aceitam o header Idempotency-Key com um identificador único por operação (recomendamos UUID v4 ou ULID):
POST /charges/(criar cobrança)POST /withdrawals/(criar saque)POST /internal-transfers/(criar transferência interna)
- Reenviar a mesma requisição com a mesma
Idempotency-Keydevolve a resposta original em vez de criar um recurso duplicado. - Reusar a mesma chave com um payload diferente retorna
409 IDEMPOTENCY_CONFLICT. - Use uma chave diferente para cada operação lógica.
Por que isso importa
Em redes instáveis, retry automático do seu cliente HTTP pode duplicar cobranças. Idempotency-Key garante que só uma vai pra frente, mesmo com 10 retries.
Rate limits #
Aplicamos limites por chave de API numa janela rolante curta. Os limites de escrita são mais apertados que os de leitura.
Quando o limite é excedido, retornamos 429 com RATE_LIMITED e o header Retry-After em segundos. Respeite o Retry-After e use backoff exponencial nos retries.
Tratamento de erros #
Erros sempre vêm em application/json com a seguinte estrutura. details é uma lista (pode estar vazia ou ausente) e cada item traz field, message e type:
{ "error": { "code": "VALIDATION_ERROR", "message": "Dados inválidos", "details": [ { "field": "amount_cents", "message": "Input should be greater than or equal to 100", "type": "greater_than_equal" } ], "trace_id": "01HV3K2N9PXY7M..." } }
Códigos de erro
O campo code usa valores canônicos estáveis. Trate sempre pelo code, não pela message (que pode mudar):
| Código | HTTP | Significado |
|---|---|---|
VALIDATION_ERROR | 422 | Payload ou parâmetros inválidos. Veja details. |
AUTHENTICATION_REQUIRED | 401 | Header de autenticação ausente. |
INVALID_CREDENTIALS | 401 | Chave ou token inválido/expirado. |
PERMISSION_DENIED | 403 | Conta sem permissão para a ação. |
API_KEY_INSUFFICIENT_SCOPE | 403 | A chave não tem o escopo exigido pelo endpoint. |
SANDBOX_NOT_SUPPORTED_FOR_WITHDRAWALS | 403 | Saque tentado com chave a4ther_test_. |
SANDBOX_NOT_SUPPORTED_FOR_TRANSFERS | 403 | Transferência interna tentada com chave a4ther_test_. |
NOT_FOUND | 404 | Recurso inexistente ou de outro merchant. |
CONFLICT | 409 | Estado conflitante com a operação. |
IDEMPOTENCY_CONFLICT | 409 | Idempotency-Key reutilizada com payload diferente. |
INSUFFICIENT_BALANCE | 422 | Saldo insuficiente para saque/transferência. |
RATE_LIMITED | 429 | Limite de requisições excedido. Veja Retry-After. |
UPSTREAM_ERROR | 502 | Falha temporária no processador. Tente de novo com backoff. |
INTERNAL_ERROR | 500 | Falha do nosso lado. Tente de novo com backoff. |
Status codes
| Status | Significado | Quando ocorre |
|---|---|---|
200 | OK | GET ou PATCH bem sucedido |
201 | Created | POST criou novo recurso |
204 | No Content | DELETE bem sucedido |
400 | Bad Request | Body inválido, campo obrigatório faltando |
401 | Unauthorized | Token ausente ou expirado |
403 | Forbidden | Escopo insuficiente, conta sem permissão, ou sandbox não suportado |
404 | Not Found | Recurso inexistente ou não pertence ao merchant |
409 | Conflict | Idempotency-Key reutilizada com payload diferente |
422 | Unprocessable | Validação de schema falhou ou estado impeditivo (ex: saldo insuficiente) |
429 | Rate Limited | Excedeu rate limit. Veja header Retry-After |
5xx | Server Error | Falha do nosso lado. Tente novamente com backoff |
Endpoints: Charges #
Criar charge
Cria uma cobrança PIX. Escopo exigido: payments.create. Use Idempotency-Key para garantir não-duplicação em retries. Suporta sandbox (o modo vem do prefixo da chave). O body é validado com schema estrito: campos fora da lista abaixo são rejeitados com 422.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
amount_cents | int | sim | Valor em centavos. Min 100 (R$ 1,00), max 100.000 (R$ 1.000,00). |
description | string | não | Texto curto que aparece pro pagador (max 500 caracteres). |
customer | object | não | Identificação do pagador: name, email, document, phone. |
expires_in_seconds | int | não | Tempo até a cobrança expirar (60 a 604800). Default do processador. |
pass_fee_to_payer | bool | não | Default true. Soma a taxa no valor cobrado, você recebe bruto. Quando false, a taxa sai do seu valor. |
affiliate_code | string | não | Código de afiliado. Se válido, registra comissão quando paga. |
split_rule_id | string | não | ID de uma regra de split do merchant (criada no painel da A4therPay). Se setado e ativo, divide o valor líquido entre os recebedores quando a cobrança for paga. |
metadata | object | não | Objeto livre persistido na cobrança. Devolvido em todos os reads e webhooks. |
# Cria uma cobranca PIX de R$ 49,90 curl -X POST https://a4therpay-api.discloud.app/api/v1/charges/ \ -H "Authorization: Bearer a4ther_test_xxx" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "amount_cents": 4990, "description": "Pedido 1042", "customer": { "name": "Ana Lima", "email": "ana@empresa.com" }, "pass_fee_to_payer": true }'
import { A4therPay } from "a4therpay"; const a4therpay = new A4therPay({ apiKey: process.env.A4THERPAY_API_KEY }); const charge = await a4therpay.charges.create({ amount_cents: 4990, description: "Pedido 1042", customer: { name: "Ana Lima", email: "ana@empresa.com" }, }, { idempotencyKey: crypto.randomUUID() }); console.log(charge.pix_copy_paste);
from a4therpay import A4therPay client = A4therPay("a4ther_test_xxx") charge = client.charges.create({ "amount_cents": 4990, "description": "Pedido 1042", "customer": {"name": "Ana Lima", "email": "ana@empresa.com"}, }, idempotency_key=str(uuid.uuid4())) print(charge.pix_copy_paste)
package main import "github.com/a4therpay/a4therpay-go" func main() { client := a4therpay.New(a4therpay.Config{ APIKey: os.Getenv("A4THERPAY_API_KEY") }) charge, _ := client.Charges.Create(&a4therpay.ChargeParams{ AmountCents: 4990, Description: "Pedido 1042", Customer: &a4therpay.Customer{Name: "Ana Lima", Email: "ana@empresa.com"}, IdempotencyKey: uuid.NewString(), }) fmt.Println(*charge.PixCopyPaste) }
use A4therPay\A4therPay; $a4therpay = new A4therPay(["api_key" => getenv("A4THERPAY_API_KEY")]); $charge = $a4therpay->charges->create([ "amount_cents" => 4990, "description" => "Pedido 1042", "customer" => ["name" => "Ana Lima", "email" => "ana@empresa.com"], ], ["idempotency_key" => bin2hex(random_bytes(16))]); echo $charge->pix_copy_paste;
Buscar charge
Retorna estado atual da cobrança. Escopo exigido: payments.read.
curl https://a4therpay-api.discloud.app/api/v1/charges/chg_test_aB3k... \
-H "Authorization: Bearer a4ther_test_xxx"const charge = await a4therpay.charges.get("chg_test_aB3k...");
charge = client.charges.get("chg_test_aB3k...")
charge, _ := client.Charges.Get("chg_test_aB3k...")
$charge = $a4therpay->charges->get("chg_test_aB3k...");
Listar charges
Listagem paginada. Escopo exigido: payments.read. Filtros: status (pending, paid, expired, cancelled, refunded), page, per_page (max 100), sort (ex: -created_at). A resposta usa o envelope { data, page, per_page, total, has_next, has_prev }.
curl "https://a4therpay-api.discloud.app/api/v1/charges/?status=paid&page=1&per_page=20" \ -H "Authorization: Bearer a4ther_test_xxx"
const { data, total } = await a4therpay.charges.list({ status: "paid", page: 1 });
page = client.charges.list(status="paid", page=1)
page, _ := client.Charges.List(&a4therpay.ListParams{Status: "paid", Page: 1})
$page = $a4therpay->charges->list(["status" => "paid", "page" => 1]);
Endpoints: Transactions #
Extrato
Lista lançamentos do extrato (créditos por cobrança paga, débitos por saque/transferência, taxas, ajustes). Escopo exigido: qualquer um entre payments.read, transfers.read ou withdrawals.read. Não suporta sandbox: chaves a4ther_test_ recebem 403. Filtros: page, per_page (max 100), sort. Envelope { data, page, per_page, total, has_next, has_prev }.
curl "https://a4therpay-api.discloud.app/api/v1/transactions/?page=1" \ -H "Authorization: Bearer a4ther_live_xxx"
Detalhe da transação
Retorna um lançamento por ID. Mesmos escopos do extrato. Não suporta sandbox.
Endpoints: Saques (Withdrawals) #
Saque PIX do saldo da sua conta A4therPay para uma chave PIX. Os endpoints de saque não suportam sandbox: chaves a4ther_test_ recebem 403 SANDBOX_NOT_SUPPORTED_FOR_WITHDRAWALS.
Criar saque
Escopo exigido: withdrawals.create. Header Idempotency-Key recomendado (UUID/ULID único por operação). Saldo insuficiente retorna 422 INSUFFICIENT_BALANCE.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
amount_cents | int | sim | Valor bruto em centavos. Min 100 (R$ 1,00), max 10.000.000 (R$ 100.000,00). |
pix_key | string | sim | Chave PIX de destino (1 a 140 chars). |
pix_key_type | enum | sim | Um de cpf, cnpj, email, phone, evp. |
description | string | não | Texto livre (max 140 chars). |
curl -X POST https://a4therpay-api.discloud.app/api/v1/withdrawals/ \ -H "Authorization: Bearer a4ther_live_xxx" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "amount_cents": 50000, "pix_key": "financeiro@empresa.com", "pix_key_type": "email", "description": "Saque semanal" }'
A resposta traz id, status (pending, processing, completed, failed), amount_cents, fee_cents, net_cents, pix_key, pix_key_type, completed_at e failure_reason quando aplicável.
Listar saques
Escopo exigido: withdrawals.read. Filtros: limit (max 100), offset, status (pending, processing, completed, failed). Envelope { data, limit, offset, total }.
Buscar saque
Retorna um saque por ID. Escopo exigido: withdrawals.read.
Endpoints: Transferências internas #
Transferência de saldo entre duas contas A4therPay. Identifique o destinatário por recipient_email ou recipient_merchant_id (exatamente um dos dois). Os endpoints não suportam sandbox: chaves a4ther_test_ recebem 403 SANDBOX_NOT_SUPPORTED_FOR_TRANSFERS.
Criar transferência
Escopo exigido: withdrawals.create. Header Idempotency-Key recomendado. Saldo insuficiente retorna 422 INSUFFICIENT_BALANCE.
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
amount_cents | int | sim | Valor em centavos. Min 100 (R$ 1,00), max 10.000.000 (R$ 100.000,00). |
recipient_email | string | condicional | Email da conta destinatária. Use este OU recipient_merchant_id. |
recipient_merchant_id | string | condicional | ID ULID do merchant destinatário (26 chars). |
description | string | não | Texto livre (max 140 chars). |
curl -X POST https://a4therpay-api.discloud.app/api/v1/internal-transfers/ \ -H "Authorization: Bearer a4ther_live_xxx" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "amount_cents": 25000, "recipient_email": "parceiro@empresa.com", "description": "Repasse parceria" }'
A resposta traz id, from_merchant_id, to_merchant_id, to_merchant_name, amount_cents, status (completed, failed, reversed) e created_at.
Listar transferências
Escopo exigido: transfers.read. Filtros: direction (sent ou received, default sent), limit (max 100), offset. Envelope { data, limit, offset, total }.
Buscar transferência
Retorna uma transferência por ID. Escopo exigido: transfers.read.
Endpoints: Test/Sandbox #
Reset sandbox
Apaga todos os charges sandbox do merchant. Só aceita chaves a4ther_test_*.
Listar magic values
Endpoint público (sem auth). Útil para pessoas e ferramentas de validação.
Webhooks #
Os webhooks são configurados no painel da A4therPay (Configurações > Webhooks); aqui documentamos os eventos disponíveis e a verificação de assinatura.
Eventos disponíveis
São oito eventos:
| Evento | Quando dispara |
|---|---|
charge.created | Cobrança criada |
charge.paid | PIX confirmado pelo banco recebedor |
charge.expired | Cobrança expirou sem pagamento |
charge.cancelled | Cobrança cancelada |
charge.refunded | Cobrança reembolsada |
payout.created | Saque registrado |
payout.completed | Saque concluído (PIX enviado) |
payout.failed | Saque falhou |
Estrutura do payload
O corpo é entregue como JSON. Você recebe o evento e o objeto relacionado (cobrança ou saque):
{ "event": "charge.paid", "charge": { "id": "chg_01HV...", "status": "paid", "amount_cents": 4990, "paid_at": "2026-06-08T19:27:23+00:00" } }
Verificar assinatura HMAC
Cada entrega chega com estes headers:
X-A4therPay-Event: nome do evento (ex:charge.paid)X-A4therPay-Timestamp: Unix timestamp da emissãoX-A4therPay-Delivery-Id: ID único da entrega (útil para deduplicar reentregas)X-A4therPay-Signature: assinatura no formatov1=<hex>
O <hex> é o HMAC SHA-256 calculado com o segredo do webhook (começa com whsec_, exibido só na criação) sobre a string "{X-A4therPay-Timestamp}." + corpo_cru. Use o corpo bruto da requisição (não o JSON re-serializado):
import crypto from "node:crypto"; function verify(rawBody, timestamp, signature, secret) { const v1 = signature.replace("v1=", ""); const expected = crypto .createHmac("sha256", secret) .update(`${timestamp}.${rawBody}`) .digest("hex"); return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1)); }
import hmac, hashlib def verify(raw_body: bytes, timestamp: str, signature: str, secret: str) -> bool: v1 = signature.removeprefix("v1=") expected = hmac.new( secret.encode(), f"{timestamp}.{raw_body.decode()}".encode(), hashlib.sha256, ).hexdigest() return hmac.compare_digest(expected, v1)
import ( "crypto/hmac" "crypto/sha256" "encoding/hex" "strings" ) func Verify(body []byte, timestamp, signature, secret string) bool { v1 := strings.TrimPrefix(signature, "v1=") mac := hmac.New(sha256.New, []byte(secret)) mac.Write([]byte(timestamp + "." + string(body))) expected := hex.EncodeToString(mac.Sum(nil)) return hmac.Equal([]byte(expected), []byte(v1)) }
function verify(string $rawBody, string $timestamp, string $signature, string $secret): bool { $v1 = str_replace("v1=", "", $signature); $expected = hash_hmac("sha256", $timestamp . "." . $rawBody, $secret); return hash_equals($expected, $v1); }
Tolerância de timestamp.
Também rejeite requests com timestamp mais de 5 minutos no passado pra evitar replay attacks.
Política de retry
Se seu endpoint não responder com 2xx, reentregamos a mesma notificação algumas vezes, com backoff exponencial crescente (tipicamente de alguns segundos até horas entre tentativas). Após esgotar as tentativas, a entrega é marcada como falha e você pode reenviá-la manualmente pelo painel.
Use o X-A4therPay-Delivery-Id para deduplicar: a mesma entrega pode chegar mais de uma vez se a sua resposta demorar.
Objetos #
Charge
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID único da cobrança |
merchant_id | string | ID do merchant dono da cobrança |
status | enum | pending, paid, expired, cancelled, refunded |
amount_cents | integer | Valor em centavos |
currency | string | ISO 4217 (só BRL por enquanto) |
payment_method | string | Sempre pix |
customer | object | null | Dados do pagador (name, email, document, phone) |
pix_copy_paste | string | null | Código copia-e-cola PIX (BR Code EMV) |
pix_qr_code | string | null | Imagem do QR Code em base64 |
fee_processor_cents | integer | Taxa do processador, em centavos |
fee_platform_cents | integer | Taxa da plataforma, em centavos |
net_amount_cents | integer | null | Valor líquido após taxas, em centavos |
metadata | object | Campos custom devolvidos em reads e webhooks |
created_at | ISO 8601 | - |
updated_at | ISO 8601 | - |
expires_at | ISO 8601 | null | Quando a cobrança expira |
paid_at | ISO 8601 | null | Preenchido quando status vira paid |
Transaction
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID único do lançamento |
merchant_id | string | ID do merchant |
type | enum | charge, refund, payout, fee, adjustment, transfer_internal, crypto_payout |
direction | enum | credit ou debit |
amount_cents | integer | Valor bruto do lançamento, em centavos |
fee_cents | integer | Taxa do lançamento, em centavos |
net_amount_cents | integer | Valor líquido, em centavos |
status | enum | pending, completed, failed |
charge_id | string | null | Referência da cobrança, quando aplicável |
created_at | ISO 8601 | - |
Webhook
Configurado no painel da A4therPay. Campos principais: id, url, events (lista), secret_prefix (só primeiros 8 chars), active, created_at.
SDKs oficiais #
Sete SDKs oficiais, um por linguagem, todos publicados nos registries: Node.js (npm), Python (PyPI), PHP (Packagist), Ruby (RubyGems), .NET (NuGet) e Java (Maven Central). Go instala via go get.
Node.js
npm install a4therpay
Python
pip install a4therpay
PHP
composer require a4therpay/a4therpay
Go
go get github.com/a4therpay/a4therpay-go
Java
com.a4therpay:a4therpay
Ruby
gem install a4therpay
.NET
dotnet add package A4therPay
Changelog #
Mantemos compatibilidade da v1. Mudanças breaking entram numa versão maior, com guia de migração. Acompanhe o changelog em a4ther.com/docs#changelog.