Integration Tutorial
Last updated
Last updated
FaTPay integrations are flexible to enable you to integrate us into any kind of apps/websites with an optimal user journey and experience.
As mentioned in [], it is the quickest and easiest way to integrate with FaTPay, that you can just add a button or directly embed our widget in your website.
FaTPay widget has responsive web design which could fit into any screens, like desktop, tablets as well as mobile devices.
Therefore, the core of integration is to construct the widget URL. And all the authentication and customization will be done by passing query parameters in that URL.
For the sake of security, Premium Partner is mandatory to add some more parameters including the signature parameter additionally. The signature algorithm is elaborated here [Widget Signature].
https://ramp.fatpay.xyz/home
All keys and values of parameters are case-sensitive.
partnerIdDescription: The unique partner ID assigned by FaTPay during onboarding process, while fixed as public for Public Partners, e.g. partnerId=public;
Format: String;
Required: Mandatory for all partners;
Signed: Mandatory to sign for Premium Partners;
timestampDescription: Unix timestamp in second, e.g. timestamp=1656600459;
Format: String(10);
Required: Mandatory for Premium Partners. While optional for others;
Signed: Mandatory to sign for Premium Partners;
timeout [only NFT Checkout Widget need]Description: Unix timestamp in second, e.g. timestamp=1656600459;
Format: String(10);
Required: Mandatory for Premium Partners. While optional for others;
Signed: Mandatory to sign for Premium Partners;
nonceDescription: Random integer, e.g. nonce=183214;
Format: String(6);
Required: Mandatory for Premium Partners. While optional for others;
Signed: Mandatory to sign for Premium Partners;
signatureDescription: Signature generated based on SecretKey and all need-to-be-signed parameters, e.g. signature=4UoZ2gIm3bcLTw5K6WdBJIaYBiXgQF3uvOfY4Ovc6+4=;
Format: String;
Required: Mandatory for Premium Partners. While optional for others;
Signed: Mandatory to sign for Premium Partners;
Eventually, we will get the widget URL as following.
Public Partner
https://ramp.fatpay.xyz/?partnerd=public
Basic Partner
https://ramp.fatpay.xyz/?partnerd=unique-partner-id
Premium Partner
https://ramp.fatpay.xyz/?partnerd=unique-partner-id×tamp=1656600459&nonce=183214&signature=4UoZ2gIm3bcLTw5K6WdBJIaYBiXgQF3uvOfY4Ovc6+4=
For more customization options, please check