Skip to main content
To use our API endpoints, you’ll need to create a service. A service is a representation of the service or platform you want to use to collect or disburse payments. You can create two kinds of service:
  1. Collection Service: This will be used to collect money on your platform. All funds will be reflected in this service on your dashboard.
  2. Disbursement Service: You can use this to issue payouts programmatically on your platform.
You cannot use the same service for both collections and disbursement. If you need both functionalities, you must create two separate services.
Each service has its own balance. Payments collected through the API go into your collection service balance, and payouts are paid from your disbursement (payout) service balance. Money is not moved between them automatically, and the API cannot move it for you. Fund your payout service from the dashboard or mobile app. See Funding Your Payout Service.
By default, payouts are deactivated on Live Mode. So, you have to Contact Support with your API User to request for activation. This should only be done when you have tested the functionality with the test keys.

​
How to Create a Service

  1. Log into your dashboard and click Developers on the extreme bottom left of the screen.
  2. Click the “New Service” button.
  3. Fill in the required details and confirm.
The service name is the name of your website or app. - The domain name can be what you have already bought or what you intend to buy. i.e. You must not own it yet. Note that you cannot use fapshi.com as your domain name, since this is the Fapshi domain. Subdomains are not allowed.
  1. Once the service is created, open it. Your apiuser and apikey for that service will be displayed; Sandbox under Sandbox and Live under API. Copy these carefully, especially the apikey because they are sensitive.
  2. Store the credentials securely (e.g., in an environment file or secure vault). Do not hard-code or commit them in public repos. Also, rotate the keys if necessary.