Payment Links

Payment links let you accept payments from anyone with a single shareable URL. Buyers click the link, confirm the amount, and pay via PIX. No checkout page, cart, or website needed.

Creating a payment link

From the dashboard

1. Navigate to Payments > Payment Links.
2. Click New Link.
3. Fill in the details:
   • Description — What the payment is for (e.g., “Logo design deposit”).
   • Amount — Fixed amount in BRL, or leave blank for the buyer to enter their own amount.
   • Expiration (optional) — Set a date after which the link becomes inactive.
4. Click Create to generate your link.

From the API

curl -X POST https://api.beinfi.com/v1/payment-links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Logo design deposit",
    "amount_cents": 15000,
    "currency": "BRL",
    "expires_at": "2025-12-31T23:59:59Z"
  }'

The response includes a url field with the shareable link and an id for tracking.

Link options

Option	Description
Fixed amount	Buyer pays the exact amount you set.
Open amount	Buyer enters any amount (useful for tips or donations).
Single use	Link deactivates after the first successful payment.
Multi-use	Link stays active for unlimited payments.
Expiration	Automatically deactivates after a specific date.

Tracking payments

Every payment link has a unique ID. When a payment is completed, BeInfi fires a payment.completed webhook event with the link ID, amount, payer details, and timestamp. You can also view the payment status in the dashboard under Payments > History.

Best practices

• Use clear descriptions so buyers know exactly what they are paying for.
• Set expiration dates on time-sensitive offers.
• Use single-use links for one-off sales to avoid duplicate payments.
• Monitor webhook events if you need to automate fulfillment after payment.