Criar Link de Pagamento

POST/api/v1/bank/wallet/payment-link/Bearer Token

Autenticação

Requer Bearer token. Veja Autenticação.

Campos da requisição

Campo	Tipo	Obrigatório	Descrição
wallet_uuid	string (UUID)	Sim	Carteira de liquidação
merchant_id	string	Sim	Identificador do comerciante
region	string	Sim	Código do país (BR, MX, CL)
currency	string	Sim	Código de moeda ISO (BRL, MXN, USD)
billing_type	string	Sim	installment ou single
charge_type	array de strings	Sim	Métodos aceitos: credit_card, pix, pix_and_card, card_and_card
name	string	Sim	Nome de exibição do link
description	string	Sim	Descrição exibida no checkout
value	number	Sim	Valor do pagamento
max_installment_count	integer	Sim	Máximo de parcelas (1 para pagamento único)
is_checkout	boolean	Não	true para uso único; false para reutilizável
redirect_url	string	Não	URL de retorno do cliente após o pagamento
webhook_url	string	Não	URL de webhook substituta para este link

Exemplo de requisição

cURL

curl -sS -X POST 'https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/' \
  -H 'Authorization: Bearer $ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "wallet_uuid": "00000000-0000-4000-8000-000000000001",
    "merchant_id": "merchant_123",
    "region": "BR",
    "currency": "BRL",
    "billing_type": "installment",
    "charge_type": ["credit_card", "pix"],
    "name": "Monthly Invoice",
    "description": "Invoice #INV-2026-042",
    "value": 250.00,
    "max_installment_count": 3,
    "is_checkout": true,
    "redirect_url": "https://merchant.example/thanks",
    "webhook_url": "https://merchant.example/webhooks/a55"
  }'

Python

import os, requests

r = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
    json={
        "wallet_uuid": "00000000-0000-4000-8000-000000000001",
        "merchant_id": "merchant_123",
        "region": "BR",
        "currency": "BRL",
        "billing_type": "installment",
        "charge_type": ["credit_card", "pix"],
        "name": "Monthly Invoice",
        "description": "Invoice #INV-2026-042",
        "value": 250.00,
        "max_installment_count": 3,
        "is_checkout": True,
    },
    timeout=30,
)
link_url = r.json()["url"]
print(f"Share this link: {link_url}")

Exemplo de resposta

{
  "payment_link_uuid": "0b9bffcb-2d96-42bb-8641-279bfc8aac19",
  "status": "active",
  "url": "https://pay.a55.tech/checkout/0b9bffcb-2d96-42bb-8641-279bfc8aac19",
  "local_currency": 250.00,
  "currency": "BRL",
  "usd_currency": 45.00,
  "eur_currency": 41.25
}

Distribuição

Canal	Método
E-mail	Incorpore a url em faturas e lembretes
WhatsApp / SMS	Cole o link HTTPS
Redes sociais	Publique em campanhas
QR code	Codifique a URL para uso em loja ou impressão
SDK	A55Pay.open({ checkoutUuid: '<uuid>' })

Compartilhe com segurança

Use HTTPS exclusivamente. Nunca cole secrets ou tokens de pré-autorização em canais públicos.