Integration Journey (API-Dashboard)

Numbering is done by order of activity. A skip shows a user moving from activities on API to activities on the dashboard. Both the dashboard (Merchant Secret & Merchant ID) and API (Partner ID, Partner Private Key, And Public Key) are needed to make successful API calls.

Onboarding Process Overview

add a figma image that illustrates the journey

Steps	Action	How To	Outcome	Implication
	API Journey IPC/IPPA	The journey through fuspay API endpoints.
1	Get the IPC or IPPA Documentation	The IPC or IPPA documentation would be sent to partenr/merchant in the support group (Slack, Whatsapp)
2	Register on the Partner Onboard Endpoint. Please know the static IP of your system.	IPC/IPPA Partner post JSON with email and partner code	Endpoint returns Partner ID, Private and Secret Key	These Credentials are used to sign and communicate with IPC/IPPA
3	Partner IP Whitelisting	The merchants send us the IPs of their server and their partner ID returned from the Register partner endpoint	Whitelisted IPs are allowed to call our system	A security measure to ensure only permitted servers can communicate with our infrastructeure
9	Post Order to Create Order Endpoint	You need to have done your wallet setup i.e step 5. Check bottom of table for step 5 There are 2 methods of creating an order . Either they have their own screen for showing their users the payment flow or they use our payment pages This decision decides how the endpoint is interacted with (what is in the header or the body of the request) More info in the doc Also, all transactional requests (collection orders or payout orders) are to be signed by the digital signature endpoint . Sample codes are in the doc
10	Fetch Order Status	This is an endpoint that helps to know the status of a collection order. NB: Order status are usually sent to the webhook registered during the order creation phase. And webhook integrity can be confirmed using the digital signature endpoint.	API response showing the status of an order
11	Payout Endpoint	This is an endpoint that does the payout. This also does account verification to avoid payouts to wrong accounts	Callback for payout is sent
12	Fetch Payout Status	This is an API call that helps to know the status of a payout request. NB: Order status are usually sent to the webhook registered during the order creation phase. And webhook integrity can be confirmed using the digital signature endpoint.
	Intrapay App Journey (Onboarding) merchants only.	Merchant is connected to their partner. on Intrapay. Also, The partner and the merchant can sometimes be the same entity
4	Platform Sign Up.	Visit intrapay.fuspay.finance	Sign up page	User on successful sign up has access to platform
5	Collection Wallet Setup	User goes to the Fiat wallet Side bar on the Intrapay App Then Input BVN/Passport Number, Name, DOB, and address	Collection Wallet is setup This allows you to have a pool of virtual accounts in Nigeria. Without wallet setup you will not be able to get Virtual accounts	Wallet is setup but without KYC there would be $100 limit (fiat equivalent) of payout and collection on the account per day
6	Partner Mapping	Click on the partner mapping tab Map to your partner in the list of partners	A merchant is mapped to the partner that was added to the IPC previously User can now see their merchant secret key and intrapay merchant ID on their Intrapay Dashboard. Merchant secret and intrapay merchant Id varies per country. you can add exxtra countries by using thre sub account feature and with the same single integration you can do collection & payout in those countries however using their own merchant secret and intrapay merchant ID	Merchant is connected to the partner. The partner and the merchant can sometimes be the same entity.
7	Copy Merchant secret key	After Mapping merchant to partner copy the merchant secret key in the partner mapping tab		Merchant secret key differs per country and is used to identify the merchants per country. The merchant secret is used to make API calls also
8	Copy Intrapay Merchant ID	Copy the intrapay merchant ID at the bottom left of the screen (in the fiat wallet section)		The merchant ID also differs per country. The Merchants ID is used to make API calls