Create Payment Link

POST/api/v1/bank/wallet/payment-link/Bearer TokenGenerate a shareable payment link

Authentication

Include your API key in the Authorization header. See Authentication for details.

Request fields

Field	Type	Required	Description
wallet_uuid	UUID	Yes	Wallet identifier
merchant_id	string	Yes	Your merchant identifier
region	string	Yes	Two-letter country code (BR, MX, CO)
currency	string	Yes	ISO 4217 currency code
billing_type	string	Yes	one_time or recurring
charge_type	array	Yes	Payment methods: credit_card, pix, boleto
name	string	Yes	Payment name shown to customer
description	string	No	Description displayed on checkout page
value	decimal	Yes	Amount in the specified currency
max_installment_count	integer	No	Maximum installments (credit card only)
is_checkout	boolean	No	true for reusable link, false for single-use
redirect_url	string	No	URL to redirect after payment completes
webhook_url	string	No	URL for payment status webhooks

Request example

cURL

curl -X POST https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_uuid": "abc-123",
    "merchant_id": "merch_001",
    "region": "BR",
    "currency": "BRL",
    "billing_type": "one_time",
    "charge_type": ["credit_card", "pix"],
    "name": "Premium Plan",
    "value": "199.90",
    "max_installment_count": 6,
    "is_checkout": false,
    "redirect_url": "https://yoursite.com/thanks",
    "webhook_url": "https://yoursite.com/webhooks/a55"
  }'

Python

import requests

resp = requests.post(
    "https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "wallet_uuid": "abc-123",
        "merchant_id": "merch_001",
        "region": "BR",
        "currency": "BRL",
        "billing_type": "one_time",
        "charge_type": ["credit_card", "pix"],
        "name": "Premium Plan",
        "value": "199.90",
        "is_checkout": False,
    },
)
print(f"Share this link: {resp.json()['url']}")

Response

{
  "payment_link_uuid": "pl-789",
  "status": "active",
  "url": "https://pay.a55.tech/checkout/pl-789",
  "local_currency": "199.90",
  "currency": "BRL",
  "usd_currency": "38.44",
  "eur_currency": "35.12"
}

Distribution channels

Channel	Method
Email	Embed the url in transactional email templates
WhatsApp / SMS	Send the link directly in a message body
Social media	Post or DM the link to customers
QR code	Encode the url into a QR code for in-store display
SDK	Use the URL inside your mobile or web SDK checkout flow

Secure delivery

Only share payment links over HTTPS channels. Never transmit links in plain-text emails or unencrypted messaging protocols.

Postman: Import the A55 API Collection to test this endpoint interactively.