After successfull onboarding callback will be send to partner on callback URL
{
"event": "MERCHANT_STATUS_ONBOARD",
"param": {
"mobile": "9876543210",
"alternate_mobile": "9876543211",
"name": "John Doe",
"firmname": "Doe Enterprises",
"shopaddress": "123, Main Market Road",
"address": "123,Main Market Road,CityCenter",
"dob": "1990-01-01",
"fathername": "Richard Doe",
"email": "[email protected]",
"pincode": "400001",
"city": "Mumbai",
"state": "Maharashtra",
"pannumber": "ABCDE1234F",
"status": "Success",
"merchantcode": "MERCH9988",
"refno": "REQ_857493",
"partnerid": "partner_johndoe",
"txnid": "TXN9910293",
"bank": {
"Bank2": "Active",
"Bank2_remarks": "Merchant activated successfully.",
"Bank3": "Not-Onboarded",
"Bank3_remarks": "Merchant not onboarded on bank",
"Bank3_dmt": "Not-Onboarded",
"Bank5": "Active",
"Bank5_remarks": "Merchant activated successfully",
"Bank6_dmt": "Active",
"Bank6": "Active",//Active - Merchant Activated Successfuly,Not-Onboarded - Merchant not onboarded on bank,Pending - Merchant EKYC is pending ,Activation-Pending - Merchant Kyc completed. kindly wait for 30 mins for bank activation,Rejected - Merchant is rejected by bank or any perticular reason.
"Bank6_next_action": "LOC_UPDATE/PAN_DOB_UPDATE",//This key will be present only in Rejected state and if this key is not present then don't take any action.
"Bank6_remarks": "Merchant activated successfully."
}
},
"param_enc":"wqewqewqe723432432"
}
Note- Bank options will be visible as per the bank/pipe activated for your Id.
{"status":200,"message":"Transaction completed successfully"}
{"status":400,"message":"Transaction failed"}
Callback Parameters Description
| Field | Example Value | Description |
|---|---|---|
event | MERCHANT_STATUS_ONBOARD | Event type identifier |
param_enc | wqewqewqe723432432 | JWT Encrypted value of the param object |
param.mobile | 9876543210 | Primary mobile number of the merchant |
param.alternate_mobile | 9876543211 | Alternate mobile number |
param.name | John Doe | Merchant's full name |
param.firmname | Doe Enterprises | Name of the merchant's firm |
param.shopaddress | 123, Main Market Road | Shop/business address |
param.address | 123, Main Market Road, CityCenter | Full address |
param.dob | 1990-01-01 | Date of birth (YYYY-MM-DD) |
param.fathername | Richard Doe | Father's name |
param.email | [email protected] | Email address |
param.pincode | 400001 | PIN code |
param.city | Mumbai | City |
param.state | Maharashtra | State |
param.pannumber | ABCDE1234F | PAN card number |
param.status | Success | Overall onboarding status |
param.merchantcode | MERCH9988 | Unique merchant code |
param.refno | REQ_857493 | Reference number of the request |
param.partnerid | partner_johndoe | Partner identifier |
param.txnid | TXN9910293 | Transaction ID |
param.bank.Bank2 | Active | Onboarding status for Bank2 |
param.bank.Bank2_remarks | Merchant activated successfully. | Remarks for Bank2 |
param.bank.Bank3 | Not-Onboarded | Onboarding status for Bank3 |
param.bank.Bank3_remarks | Merchant not onboarded on bank | Remarks for Bank3 |
param.bank.Bank3_dmt | Not-Onboarded | DMT status for Bank3 |
param.bank.Bank5 | Active | Onboarding status for Bank5 |
param.bank.Bank5_remarks | Merchant activated successfully | Remarks for Bank5 |
param.bank.Bank6 | Active, Not-Onboarded, Pending, Activation-Pending, Rejected | Status on Bank 6 ecosystem. Allowed Values: • Active: Activated successfully. • Not-Onboarded: Not onboarded yet. • Pending: EKYC is pending. • Activation-Pending: KYC complete; wait 30 mins for activation. • Rejected: Onboarding rejected by bank. |
param.bank.Bank6_dmt | Active | DMT status for Bank6 |
param.bank.Bank6_remarks | Merchant activated successfully. | Remarks for Bank6 |
param.bank.Bank6_next_action | LOC_UPDATE / PAN_DOB_UPDATE | Present only in Rejected state. LOC_UPDATE → call Update Location API. PAN_DOB_UPDATE → call PAN Name Update API. If absent, no action needed. |
Bank 6 Status Explanation
| Status Value | Remarks |
|---|---|
| Not-Onboarded | Merchant not onboarded on bank |
| Pending | Merchant EKYC is pending |
| Activation-Pending | Merchant KYC completed. kindly wait for 30 mins for bank activation |
| Active | Merchant Activated Successfully |
| Rejected | Merchant is rejected by bank or any particular reason. also check for bank6_next_action and take the required action accordingly |
