Introduce a new attribute named required_fields to the Payment Options API, which will house an array of required fields such as msisdn, email, first_name, last_name, card, browser_details, or redirect_url. See Payment Options for further details.
Fields country_code, currency, language and payment_method are not longer required and are now optional in Payment API. Note that the default language is EN.
The attributes first_name, last_name, email, msisdn, narration, and redirect_url have been made optional and their necessity is determined by the required_field attribute associated with the chosen payment option.
1.5.5 (2024-02-01)
Add new error codes (receiver.not.registered, provider.similar.trx.error)
Add more details regarding "similar transaction" error. See Status Codes
1.5.4 (2023-12-18)
Introduce two additional fields, rounded and original_amount, to both collections and payouts. The rounded field signifies whether the transaction amount has been rounded. The original_amount field stores the initial amount provided by the merchant. Both fields are now accessible in transaction responses and callbacks.
Add supports_decimals field in payment options.
1.5.3 (2023-11-19)
Add a new is_multiple_of field in payment/payout options. See Payout Optionsdocumentation.
Update test data with new countries (LR, CD, MG)
1.5.2 (2023-11-16)
Fix callback payloads in documentation.
1.5.1 (2023-09-12)
Due to provider-side constraints, the content N/A is no longer valid in the narration field, and requests containing this value will be rejected.
1.5 (2023-09-08)
Add required_fields to payout options
Update successful and failed mobile phone numbers for the sandbox environment
Add emailfield into the request body for payouts. email is still optional except for some payout options. Currently, it affects Nigeria and South Africa only.
Add a supports_decimals field to the payout options API. This field indicates whether decimals are allowed in the amount.
1.4 (2023-07-04)
Add voucher_required and voucher_instructions to the payment option response body
Update documentation regarding vouchers or OTP codes
1.3 (2023-06-05)
Fix card refund documentation
Add statuses: refund_requested and refund_failed
Various documentation fixes
1.2 (2023-04-21)
Add /payouts endpoint to request disbursements
Add /payouts/{transactionId} endpoint to query payout transaction statuses
Add /wallet/balanceto query the balance account
Add more error codes
Add fees object in payment responses. This object contains details about fees applied to the transaction
