{"version":1,"pages":[{"id":"w27YFP6zfY2e9fPcnzB4","title":"Introduction","pathname":"/","siteSpaceId":"sitesp_q2lw5","description":"The EllyPay platform enables merchants (businesses and online platforms) to process payments across multiple payment options. The document describes the current version of the API."},{"id":"6EulHkiWtpe5mnzsIkMp","title":"Registration","pathname":"/getting-started/registration","siteSpaceId":"sitesp_q2lw5","description":"Any entity interested in the EllyPay  API needs to register and fulfil the compliance/KYC requirements before they are granted access to the platform.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"J8wlefYnL3ZJxYDmLZWz","title":"Error Handling","pathname":"/getting-started/error-handling","siteSpaceId":"sitesp_q2lw5","description":"The EllyPay API uses HTTP status codes to indicate the success or failure of the API requests. The section describes the summary of these codes and what they mean in our context.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"BWmgx4QkCais7YvPw9Ha","title":"Authentication","pathname":"/getting-started/authentication","siteSpaceId":"sitesp_q2lw5","description":"The EllyPay API uses a key pair (Public and Secret Keys) for authentication. To make an authenticated request to our API, you need to pass custom headers as described in this section.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"8XVOdyWm2uNfLNUEEnwn","title":"Merchant Account Credentials","pathname":"/getting-started/merchant-account-credentials","siteSpaceId":"sitesp_q2lw5","description":"For every approved merchant account, a set of credentials is automatically generated and stored on the record. This section describes how the merchant can manage credentials after the account creation","breadcrumbs":[{"label":"Getting Started"}]},{"id":"Wa2N8q7PKYtcGz2XNHc3","title":"Generate Secret Key","pathname":"/getting-started/merchant-account-credentials/generate-secret-key","siteSpaceId":"sitesp_q2lw5","description":"The section below describes (with screenshots) how to generate and store a new secret key. The process assumes that you're already logged in to the merchant dashboard.","breadcrumbs":[{"label":"Getting Started"},{"label":"Merchant Account Credentials"}]},{"id":"OXheYU893mMDDLzs3jyQ","title":"Regenerate Security Keys","pathname":"/getting-started/merchant-account-credentials/regenerate-security-keys","siteSpaceId":"sitesp_q2lw5","description":"The section below describes (with screenshots) how to generate a new set of security keys. The process assumes that you're already logged in to the merchant dashboard.","breadcrumbs":[{"label":"Getting Started"},{"label":"Merchant Account Credentials"}]},{"id":"NRHcEPk0YnHm5IJnP2Z8","title":"Supported Countries","pathname":"/getting-started/supported-countries","siteSpaceId":"sitesp_q2lw5","description":"The EllyPay platform supports multiple payment methods, transaction types and currencies across a number of countries or regions. Merchant accounts will be enabled for only what they request.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"UU3uisYYCgpcM3o8vata","title":"Transaction Limits","pathname":"/getting-started/transaction-limits","siteSpaceId":"sitesp_q2lw5","description":"For some of the transaction currencies supported, there are limits that control what a single transaction account is able to do per transaction and in a 24hr period.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"7Ei5rMzadsMa4DDypLOo","title":"Sandbox Test Accounts","pathname":"/getting-started/sandbox-test-accounts","siteSpaceId":"sitesp_q2lw5","description":"The table below describes the test account numbers that can be used for tests on the sandbox to simulate transactions. Two scenarios (success and failure) can be simulated based on the account number.","breadcrumbs":[{"label":"Getting Started"}]},{"id":"sNJWFwqWuJSNTiaRYqHV","title":"RSA Public Keys","pathname":"/getting-started/rsa-public-keys","siteSpaceId":"sitesp_q2lw5","description":"This section shares the two public keys used for the two environments (Sandbox and Production). The keys can be copied and stored as files to later be used in transaction processing","breadcrumbs":[{"label":"Getting Started"}]},{"id":"2r6bnW9Kwi4A5g2XMIAS","title":"Balance Inquiry","pathname":"/utility-functions/balance-inquiry","siteSpaceId":"sitesp_q2lw5","description":"The API allows the merchant to check the balance(s) for the different currencies they might hold.","breadcrumbs":[{"label":"Utility Functions"}]},{"id":"E8qh5wAQIPuCQxEHFHxg","title":"Payment Options","pathname":"/utility-functions/payment-options","siteSpaceId":"sitesp_q2lw5","description":"Before any transaction request is performed, it's recommended that the payment options available to the merchant account are known. This endpoint returns that list.","breadcrumbs":[{"label":"Utility Functions"}]},{"id":"ZSh9aB3wgEGU3gbm5GiI","title":"Payout Bank Codes","pathname":"/utility-functions/payout-bank-codes","siteSpaceId":"sitesp_q2lw5","description":"For all countries/currencies where EllyPay supports bank payouts, there's need to specify the unique code for the bank to which the funds are to be sent. These codes are available via the API","breadcrumbs":[{"label":"Utility Functions"}]},{"id":"tYbH70IzC24kprxz80zz","title":"Transaction Status Verification","pathname":"/utility-functions/transaction-status-verification","siteSpaceId":"sitesp_q2lw5","description":"In some situations, the merchant might wish to confirm the status of the transaction. This document resource describes the process of retrieving the transaction details (status inclusive)","breadcrumbs":[{"label":"Utility Functions"}]},{"id":"mw6nqs4NHiBOx8AvohV1","title":"Handling Notifications/Callbacks","pathname":"/utility-functions/handling-notifications-callbacks","siteSpaceId":"sitesp_q2lw5","description":"Whenever the status of the transaction changes (to processing, failure or success), we notify your service via callbacks. Below are the hints to take note of as regards these payment notifications.","breadcrumbs":[{"label":"Utility Functions"}]},{"id":"wfBHuWyyr5i5uZsVBwOe","title":"Callback Events","pathname":"/utility-functions/handling-notifications-callbacks/callback-events","siteSpaceId":"sitesp_q2lw5","description":"Every callback payload has a parameter named event and its purpose is to communicate the reason for the callback. The section below describes the various values the parameter can take.","breadcrumbs":[{"label":"Utility Functions"},{"label":"Handling Notifications/Callbacks"}]},{"id":"oIwPtHN5YxEe4a0U5aCk","title":"Getting Started","pathname":"/funds-collection/getting-started","siteSpaceId":"sitesp_q2lw5","description":"Collections are payments that the merchant receives into their account. The sections here will highlight how the EllyPay platform supports these.","breadcrumbs":[{"label":"Funds Collection"}]},{"id":"fYOpn6LuhxLuIyJ4WUSM","title":"Mobile Money Collection","pathname":"/funds-collection/mobile-money-collection","siteSpaceId":"sitesp_q2lw5","description":"The API supports mobile money as described in the Supported Countries section. The section below will guide you through the process of accepting Mobile Money","breadcrumbs":[{"label":"Funds Collection"}]},{"id":"FraZQKyAaCESPaoX0uHk","title":"Getting Started","pathname":"/funds-payout/getting-started","siteSpaceId":"sitesp_q2lw5","description":"Payouts, also sometimes called Disbursements, are outbound fund transfers from your merchant account to supported mobile money channels or bank accounts.","breadcrumbs":[{"label":"Funds Payout"}]},{"id":"xjfGqqlqNanUdj3hStDn","title":"Mobile Money Payouts","pathname":"/funds-payout/mobile-money-payouts","siteSpaceId":"sitesp_q2lw5","description":"The API enables you to transfer funds directly from your available balance to a mobile money account. The documentation below explains further.","breadcrumbs":[{"label":"Funds Payout"}]},{"id":"DANFd6xE9jXZ3Xfpyvcy","title":"Bank Account Transfers","pathname":"/funds-payout/bank-account-transfers","siteSpaceId":"sitesp_q2lw5","description":"The API enables you to transfer funds directly from your available balance to supported bank accounts. The documentation below explains further.","breadcrumbs":[{"label":"Funds Payout"}]},{"id":"U6xgIhsROHJ1Jky0IRkV","title":"Getting Started","pathname":"/service-payments/getting-started","siteSpaceId":"sitesp_q2lw5","description":"Service payments is a term EllyPay uses to describe outbound (mostly) payments from your merchant account to supported service accounts e.g. UMEME, URA, mobile services etc.","breadcrumbs":[{"label":"Service Payments"}]},{"id":"xchW5QFIpbPqLU8Gqn1I","title":"Services List","pathname":"/service-payments/services-list","siteSpaceId":"sitesp_q2lw5","description":"This section of the documentation describes how the list of services can be retrieved. Services are categorised and can be retrieved based on the category","breadcrumbs":[{"label":"Service Payments"}]},{"id":"Tqfh8Fn8v8I2WQnWQRXh","title":"Service Packages List","pathname":"/service-payments/service-packages-list","siteSpaceId":"sitesp_q2lw5","description":"Some services have packages OR a price list that describes the available items for payment/subscription. This section describes how a service's price/package list can be obtained.","breadcrumbs":[{"label":"Service Payments"}]},{"id":"5e3qvKKuGSczK5bLQo2w","title":"Service Choices List","pathname":"/service-payments/service-choices-list","siteSpaceId":"sitesp_q2lw5","description":"Some service items have choice lists that support their purchase. This section describes how a service's choice list can be obtained.","breadcrumbs":[{"label":"Service Payments"}]},{"id":"adMPk6Q5A6RIaQdXdzzK","title":"Account Validation","pathname":"/service-payments/account-validation","siteSpaceId":"sitesp_q2lw5","description":"The EllyPay API platform has a pre-requisite that before a payment is made for any of the products, the recipient account needs to be validated to confirm the name. The section describes as follows;","breadcrumbs":[{"label":"Service Payments"}]},{"id":"1Thyqp1GMOiTNFoAZCGp","title":"Payment Confirmation","pathname":"/service-payments/payment-confirmation","siteSpaceId":"sitesp_q2lw5","description":"After the account validation has successfully responded with the account details. You can proceed to confirm the payment for the service","breadcrumbs":[{"label":"Service Payments"}]},{"id":"mBSeeMxzjBAGPehaIDuN","title":"HMAC Signature Verification","pathname":"/callbacks/hmac-signature-verification","siteSpaceId":"sitesp_q2lw5","description":"The section describes how the hmac signature sent in the callback header can be verified","breadcrumbs":[{"label":"Callbacks"}]},{"id":"ql6UH9G9LNRDzv0wXgcJ","title":"RSA Signature Verification","pathname":"/callbacks/rsa-signature-verification","siteSpaceId":"sitesp_q2lw5","description":"The section describes how the RSA signature sent in the callback header can be verified. The signature is generated using an RSA Signing. For verification to succeed, the public key is required.","breadcrumbs":[{"label":"Callbacks"}]},{"id":"jucDCfI4ezi9TYbphdCh","title":"API Reference","pathname":"/knowledge-base/api-reference","siteSpaceId":"sitesp_q2lw5","description":"","breadcrumbs":[{"label":"Knowledge Base"}]},{"id":"1S96sPrQSQWJFpp4qDiK","title":"Availing Payout Funds","pathname":"/knowledge-base/availing-payout-funds","siteSpaceId":"sitesp_q2lw5","description":"Some merchants wish that collected funds can be used for processing payouts/disbursements. This section what the merchant needs to do to avail balance for handling payouts","breadcrumbs":[{"label":"Knowledge Base"}]},{"id":"q7XIxupZ0IfuorbiK9UT","title":"Availing Service Payment Funds","pathname":"/knowledge-base/availing-service-payment-funds","siteSpaceId":"sitesp_q2lw5","description":"Some merchants wish that collected funds can be used for processing service payments. This section describes what the merchant needs to do to avail balance for handling service payments.","breadcrumbs":[{"label":"Knowledge Base"}]},{"id":"bfbc8JfV4kH8S2euUgAx","title":"Funds Settlement","pathname":"/knowledge-base/funds-settlement","siteSpaceId":"sitesp_q2lw5","description":"Some merchants wish that collected fund can be settled every so often. This section describes how the merchant can initiate a funds settlement request to the finance team for handling.","breadcrumbs":[{"label":"Knowledge Base"}]},{"id":"NC5hjyBqecMKa4lI0qLS","title":"Cross Currency Transactions","pathname":"/knowledge-base/cross-currency-transactions","siteSpaceId":"sitesp_q2lw5","description":"The API allows for cross currency transactions whereby the request currency does not match the currency of the selected payment option. The platform handles the conversion appropriately.","breadcrumbs":[{"label":"Knowledge Base"}]}]}