Payment Link
Quick Reference
WhatAPI-generated payment URLs
WhyOmnichannel distribution without embedding checkout code
DifficultyBeginner
PrerequisitesAuthentication → Wallet
A payment link creates a shareable URL that opens A55 checkout — ideal for invoices, support-assisted sales, and lightweight storefronts without an embedded SDK.
Why payment links
| Benefit | Detail |
|---|---|
| Minimal code | Generate links from API or dashboard |
| Omnichannel | WhatsApp, email, SMS, social |
| Hosted checkout | Same methods as standard checkout |
| Single-use or reusable | is_checkout controls behavior |
Create a link
POST https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/
Authorization: Bearer $ACCESS_TOKEN
The response returns a url pointing to https://pay.a55.tech/checkout/{uuid} (exact path follows your API response).
Distribution
- Email — embed in invoices and reminders.
- WhatsApp / SMS — paste the HTTPS link.
- Social — post the link on campaigns.
- QR — encode the URL for in-store or print.
is_checkout flag
| Value | Behavior |
|---|---|
true | Single-use, checkout-style flow |
false | Reusable until revoked |
Operational details
Confirm expiry, max redemptions, and idempotency rules with your integration manager — they may vary by product configuration.
Examples
- cURL
- JSON body
- Response
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"
}'
{
"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"
}
{
"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
}
Embed with SDK
A55Pay.open({ checkoutUuid: '<uuid-from-payment-link>' });
Share safely
Use HTTPS only. Do not paste secrets or pre-auth tokens in public channels.