New Merchants

In order to accept payments on behalf of your merchants, the merchant must submit an application to the underwriting to get approved. Once approved, the merchant will be able to accept payments.

Onboarding merchants is quite simple and can be done in a few steps.

Submit Merchant Application via API

You will submit the merchant application via an API request. We will return back a body containing the necessary information for you to start accepting payments when the merchant has been approved.

Submit New Merchant Application
curl 'https://api.prahsys.com/merchant/n1/onboarding/[CHANNEL_PARNTER_ID]/new' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer [API_KEY]' \
  --data-raw '[NEW_MERCHANT_BODY]'

Note: You can get your channel partner ID by going to the Prahsys Dashboard 

Note: You can get the zod schema for the body here.

New Merchant Response
{
  "success": true,
  "message": "Merchant created and application submitted to underwriting team.",
  "data": {
    "newMerchantId": "JSBBaXXXXX",
    "merchantApplicationId": 123456,
    "signingUrl": "string"
  }
}

Make sure to store the Merchant ID and the application id to your database. You will be using the application id to track the status of the application and the merchant ID to accept payments on behalf of the merchant.

Present Signing Document to the Merchant

In order for us to start onboarding the merchant, they have to sign the necessary agreements.

Listen for Webhook

After the merchant has signed the necessary agreements, we will send a webhook to your endpoint with the merchant ID and the a status if they are ready for processing.

Webhook merchant.readyForProcessing body
{
  "merchantId": "JSBBaXXXXX",
  "message": "Approved and Boarded",
  "readyForProcessing": true
}

Once you have received this webhook, you can start accepting payments on behalf of the merchant.

Learn how to use our Payments API