Tutorials
The Tutorials section provides step-by-step guidance for using the TalusPay API to handle key business operations.
How to Create a Merchant, Process a Payment, and Set Up a Webhook with TalusPay API
1. Create a Merchant
To create a new merchant using the TalusPay API, refer to the Create Merchant API Documentation.
Steps:
- Use the
POST
method to create a new merchant. - Include the relevant business and contact information in the request body.
- On success, you will receive a
merchantId
that can be used for future operations. - Wait till merchant application onboarding is approved
onboarding_status: APPROVED
2. Create a Payment (Scan-to-Pay)
After successfully creating a merchant, you can initiate a payment using the Scan-to-Pay feature. For more details, refer to the Create Scan to Pay Payment API Documentation.
Steps:
- Use the
POST
method with the merchant'smerchantId
. - Specify the payment amount, currency, and other relevant details in the request body.
- You will receive a response with a
paymentRequestId
and a QR code URL for the customer to scan and pay.
3. Set Up a Webhook
To receive real-time notifications about events such as payment completions, merchant onboarding status, you can set up a webhook. Full instructions can be found in the Create Webhook API Documentation.
Steps:
- Use the
POST
method to create a webhook for specific scope events likemerchant
andcharge
that will return events ex.mercahnt.approved
orcharge.paid
. - Provide the target URL for the webhook and an optional secret for securing the webhook.
- On success, you will receive a
webhookId
for managing or updating the webhook later.
By following these steps, you can create merchants, process payments, and set up webhooks using the TalusPay API efficiently.