ONBOARD STATUS CALLBACK

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

FieldExample ValueDescription
eventMERCHANT_STATUS_ONBOARDEvent type identifier
param_encwqewqewqe723432432JWT Encrypted value of the param object
param.mobile9876543210Primary mobile number of the merchant
param.alternate_mobile9876543211Alternate mobile number
param.nameJohn DoeMerchant's full name
param.firmnameDoe EnterprisesName of the merchant's firm
param.shopaddress123, Main Market RoadShop/business address
param.address123, Main Market Road, CityCenterFull address
param.dob1990-01-01Date of birth (YYYY-MM-DD)
param.fathernameRichard DoeFather's name
param.email[email protected]Email address
param.pincode400001PIN code
param.cityMumbaiCity
param.stateMaharashtraState
param.pannumberABCDE1234FPAN card number
param.statusSuccessOverall onboarding status
param.merchantcodeMERCH9988Unique merchant code
param.refnoREQ_857493Reference number of the request
param.partneridpartner_johndoePartner identifier
param.txnidTXN9910293Transaction ID
param.bank.Bank2ActiveOnboarding status for Bank2
param.bank.Bank2_remarksMerchant activated successfully.Remarks for Bank2
param.bank.Bank3Not-OnboardedOnboarding status for Bank3
param.bank.Bank3_remarksMerchant not onboarded on bankRemarks for Bank3
param.bank.Bank3_dmtNot-OnboardedDMT status for Bank3
param.bank.Bank5ActiveOnboarding status for Bank5
param.bank.Bank5_remarksMerchant activated successfullyRemarks for Bank5
param.bank.Bank6Active, Not-Onboarded, Pending, Activation-Pending, RejectedStatus 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_dmtActiveDMT status for Bank6
param.bank.Bank6_remarksMerchant activated successfully.Remarks for Bank6
param.bank.Bank6_next_actionLOC_UPDATE / PAN_DOB_UPDATEPresent 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 ValueRemarks
Not-OnboardedMerchant not onboarded on bank
PendingMerchant EKYC is pending
Activation-PendingMerchant KYC completed. kindly wait for 30 mins for bank activation
ActiveMerchant Activated Successfully
RejectedMerchant is rejected by bank or any particular reason. also check for bank6_next_action and take the required action accordingly