This release includes important API updates and improvements, including enhanced payment link functionality, OTP verification for Ivory Coast Orange deposits, revised transaction limits, updated country support, and a new best practices guide.
Prefilled Customer Data - you can now generate payment links with prefilled customer data. By passing fields such as first_name, last_name, email, and mobile, the user is directed straight to the checkout page with their details already filled in.
Previously: Payment links required customers to manually enter their information at checkout.Sample V2 Payment link creation API with no customer data:
Copy
{ "client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr", "salt": "justrandomstring", "sender": "John.co", "timestamp": 1709363033, "signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807", "params": { "business_name": "my business", "item_name": "item name", "callback_url": "https://webhook.site/unique-id", "redirection_url": "https://webhook.site/unique-id", "amount": "5000", "logo": "This is brand logo. Use the base64 format to upload a file of maximum 2MB size.", "country_id": "This is integer value. You can get country id from supported country table attached here.", "currency": "KES"}
Now: Backward compatibility with v2. You can pass in the customer data.
Sample V3 API Payment link with customer data:
Copy
{ "client_id": "K1PoY1WYricSpXh6Wm24twnk6ecPJOWrHGsqiKJr", "salt": "justrandomstring", "sender": "John.co", "timestamp": 1709363033, "signature": "2193d01d50d4bd5da234ac0e0add5d4ccb40907a1b1ab27a12d2c1d88a5d5807", "params": { "business_name": "my business", "item_name": "item name", "callback_url": "https://webhook.site/unique-id", "redirection_url": "https://webhook.site/unique-id", "amount": "5000", "logo": "This is brand logo. Use the base64 format to upload a file of maximum 2MB size.", "country_id": "This is integer value. You can get country id from supported country table attached here.", "currency": "KES", "first_name": "First name", "last_name": "Last name", "email":"john.dpe@example.com", "mobile": "2547123xxxx7"}