Introduction
Payment Links allow you to collect payments from customers without a full website integration. You can generate a unique link, share it via email, SMS, or chat, and get paid instantly. This is ideal for:- Sending invoices to clients
- Collecting payments for custom orders
- Accepting payments without a website
- Recovering abandoned carts
Easy Sharing
Share links via email or SMS
Customizable
Set custom expiry dates and pre-fill customer details
Secure
Secure hosted payment page handled entirely by EximPe
Prerequisites
Before you begin, ensure you have:- Merchant Account: An active EximPe merchant account
- Credentials: Your Client ID and Client Secret
- Domain Whitelist: Whitelisted your website domain for integration
- Webhook URL: A secure endpoint to receive payment status updates
Integration Steps
- Create Payment Link: Call the API to generate a link.
- Share Link: Send the link to your customer.
- Track Status: Monitor payment status via webhooks or API.
Step 1: Create Payment Link
To create a payment link, you need to provide the payment details such as amount, currency, and customer information.cURL
Response
link_id is the payment link’s ID. It has the same value as payment_id, which is kept for compatibility.
Expiry Date: You can set an optional
expiry_date for the link. If not provided, it defaults to 1 year.📚 API Reference
Create Payment Link API - View complete documentation including all parameters.
Step 2: Share Payment Link
Once you have thepayment_link URL from the response, you can share it with your customer through any channel:
- Email: Send it in an invoice email.
- SMS / WhatsApp: Send it as a text message.
- Social Media: Share it in DMs.
- QR Code: Generate a QR code for the link.
Step 3: Track Payment Status
Since the payment happens on a hosted page, you need to know when the payment is completed. You can do this via:1. Webhooks (Recommended)
Listen for thePAYMENT_SUCCESSFUL webhook event to get real-time updates.
2. Poll Status API
You can also periodically check the status of the payment link or the order associated with it.📚 API Reference
Get Payment Link API - Check the current status of a payment link.
Tracking a payment link
A payment link and the payment made through it share one ID. Create Payment Link returns it aslink_id, and as payment_id with the same value; the payment webhooks for the link’s payment carry it as both. Use it to manage the link (Retrieve Payment Link, Deactivate Link) and to refund and reconcile the payment (Create Refund).
Managing Payment Links
EximPe provides APIs to manage the lifecycle of your payment links:- List Links: View all your generated payment links.
- Retrieve Link: Get details of a specific payment link.
- Deactivate Link: Cancel a link before it expires.