Payment Links let you collect payments by sharing a URL — no integration required.
When to use Payment Links
- Invoicing — Send payment requests via email, SMS, or WhatsApp
- Social selling — Share links on social media
- No-code payments — Accept payments without a website
- One-time charges — Collect specific amounts from specific customers
Create a Payment Link
- Go to Dashboard → Payment Links
- Click Create Link
- Set the amount, currency, and description
- Share the generated URL with your customer
curl -X POST https://api.simiz.io/v1/organizations/{orgId}/payment-links \
-H "Authorization: Bearer sk_test_xxx" \
-H "Content-Type: application/json" \
-d '{
"name": "Invoice #789",
"amount": 15000,
"currency": "XAF",
"description": "Payment for consulting services",
"maxUses": 1,
"collectPhone": true,
"collectEmail": true
}'
Features
| Feature | Description |
|---|
| Fixed or open amount | Set a specific amount, or leave empty to let the customer enter the amount (with optional min/max) |
| Expiration | Set an expiry date for time-limited offers |
| Multi-use | Accept multiple payments on the same link (set maxUses or leave unlimited) |
| Customer data collection | Collect phone, email, and/or name at checkout |
| Metadata | Attach custom key-value data for reconciliation |
Link statuses
| Status | Description |
|---|
ACTIVE | Link is available for payments |
EXPIRED | Link has passed its expiration date |
INACTIVE | Link was manually deactivated |
Manage links
# List all payment links
curl https://api.simiz.io/v1/organizations/{orgId}/payment-links \
-H "Authorization: Bearer sk_test_xxx"
# Get link statistics
curl https://api.simiz.io/v1/organizations/{orgId}/payment-links/stats \
-H "Authorization: Bearer sk_test_xxx"
# Deactivate a link
curl -X DELETE https://api.simiz.io/v1/organizations/{orgId}/payment-links/{linkId} \
-H "Authorization: Bearer sk_test_xxx"
Use multi-use links for recurring scenarios like donations. Set maxUses to limit the number of payments a link can accept.
