Sarepay is a payment processor, offering a comprehensive suite of financial services tailored specifically for fintech companies and innovators. Our primary objective is to facilitate the delivery of best-in-class user experiences.

Want to try it quickly?

To get started, sign up on https://staging-app.sarepay.com to obtain you API Keys.

Making a request

In order to initiate a request to the endpoints, it is essential to authorize each request using a bearer token. This bearer token is derived from API Keys section of the Sarepay dashboard.

e.g Authorization Bearer SECRET_KEY

Services:

These services are currently available and are set to expand as we incorporate more integrations.

Transfer Service

These APIs facilitates fund transfer from your Sarepay wallet to any bank account within Nigeria. With these APIs at your disposal, you can seamlessly initiate and complete transactions, ensuring your funds are securely and promptly transferred to the designated bank account within the Nigerian financial landscape.

Virtual Accounts

These APIs facilitates virtual account generation for merchants and their customers. This service allows virtual account for both personal and corporate accounts as well as one time account in case of facilitating payment via transfer in a payment gateway.

Charge Service

These APIs are the driving force behind Sarepay's checkout page. If you want to personalize your checkout page, you can achieve that by utilizing this specific set of APIs.

HTTP Status Codes

• 200: A successful request occurred, do note that the description field on the response can contain further steps to be carried on this transaction

• 400: Data validation error occurred due to inconsistent data supplied by the client

• 401: Invalid request authorization, which might be due to invalid API key or the client is not registered for the service being accessed.

• 500: An internal server error at our End, this should be reported if it persists.

Webhooks

These are ways we notify our merchants of difference asynchronous events. A sample webhook is seen below

{"event":"collection.virtualaccount.successful","data":{"customer_reference":"wls_FKBYSX51LVR6AEM1693813825","transaction_reference":"wls_FKBYSX51LVR6AEM1693813825","processorReference":"hjfgkdlkjfhgdkswwwq","amount":"2000.00","charge":"20.00","netAmount":"2020.00","expectedAmount":"2000.00","channel":"Virtual Account","sender":{"originatorBank":"UBA","originatorName":"Test","originatorAccountNumber":"123456789"},"recipient":null,"status":"Successful","createdAt":"2023-09-04T07:50:25.000000Z","updatedAt":"2023-09-04T07:50:25.000000Z","meta":{"customerMeta":null,"notification":{"amount":"2000","bankcode":"058","bankname":"UBA","craccount":"8941011002","narration":"Test Notification","sessionid":"bjkxlkdjhgfdksawwwq","craccountname":"Test Account","originatorname":"Test","paymentreference":"hjfgkdlkjfhgdkswwwq","originatoraccountnumber":"123456789"}}},"hash":"BkLUHqnU\/2tpejYhBCGOo8WKcUnwIneWnv3WybMRLBc="}