Getting Started
Fiat Checkout Quick Start
7 min
this document provides a quick overview of how to create a fiat checkout order and receive payments from users fiat checkout order this api creates a payin order and returns a website url the website returned can be loaded in a browser user can complete their payment in this webpage once the user has done the payment, the webpage shows success screen and redirects the user to the callbackurl pay3 backend also sends events to your backend service updating realtime status update of the payment once you receive the event, you could call order details api to get the status, paid amount and payment details steps step 1 get access token to generate the access token, you will call the api with the api secret and client id please refer to the docid\ lq v6ff 2i h1o3xd5kka step 2 create a signature with parameters the request to create a crypto checkout order requires a header signature this can be generated using the javascript code snippet here docid\ twxek26s1fefj4vbxdno7 step 3 call docid\ twxek26s1fefj4vbxdno7 api sample payload const payloadfiatcheckout = { "requestid" " ", // todo application’s order id, send unique id for every order (preferably uuid) "currencyid" "usd usa", // please reach out to pay3 team for enabled currencies,countries in your clientid "fiatamount" "5 00", // fiat amout in specified currency (in this in usd) "paymentmethodid" "card", // payment method enabled for your client id for this currency,country "clientid" " ",// todo your clientid "email" "user\@email com", //pass the email for the user (will be considered uniqueid if userid is not passed) "mode" "returnurl", // optional this will return standalone web url to accpet crypto payment "callbackurl" "https //yoursite com/successpage" // optional this will return the user } sample response { "requestid" "9824649238", "token" "a35dc551 9fb4 491c 9f9b 44d9c2ef4b32", "status" "created", "offerinfodata" { "useraddress" "user\@email com", "clientid" "your client id", "selectedpaymentmethod" "your paymentmethodid", "totalfiatamount" "5 00", "expiryts" "2025 04 21t16 12 09 287975+00 00", "currencyid" "your currency id", "type" "buy" }, "url" "https //pprod ui pay3 app/ " } step 4 redirect user to checkout page once the user clicks on checkout, redirect the user to the " url " in the response above step 5 user makes the payment the user enters card details and complete the payment step 6 payment verified by pay3 the pay3 backend detects and verifies the transaction once confirmed, the checkout page displays a success screen step 7 redirect to merchant callback url ui is redirected to callbackurl provied in the create order payload here eg " https //yoursite com/successpage " step 8 listen for webhook events pay3 backend sends webhook notifications with status updates upon receiving an event, you may call the docid\ evzg5iqkqdzsr1 pkknds to retrieve the latest order details