Skip to main content

Instamojo Integration with Instamojo Payment Gateway allows you to generate payment links, view payment status, and create refunds with the platform.


Configuring the integration with Instamojo is straightforward. Follow the steps defined below to start integrating:

  1. Sign up on Instamojo.

    • Test Mode: This mode is for testing and for developers who are just getting started in Instamojo Integration. Test Mode is completely Free of Charge but requires KYC to be completed. No real charges will be made, even if we give our valid card details in the Instamojo use ( to sign up.
    • Live Mode: As the name suggests, In the Live Mode, we would be charged for real. To work on Live Mode, we have to give our bank account and KYC Details. Use ( to Signup.
  2. After signing up, log in to Dashboard > Go to API & Plugins > Generate Credentials > Select Direct Rest API Integration.


  1. Copy the Client ID and Client Secret.

  2. Go to the integration page of and search for Instamojo then Paste the client Id and Client Secret in the form.

  3. For sandbox environment use as baseUrl and for production env use as baseUrl

  4. If you have multiple accounts, follow the above mentioned steps to add each of them.

  1. Enter a unique name for each account to easily identify them within the platform. It is recommended to use a name that aligns with its purpose for better usability.
  2. You can add a maximum of 5 merchant accounts.
  3. In a two-tier environment, such as bots with only Development/Live environments, you can add account names only in the development mode. Once added and flows have been built, in the Live mode, you can only choose the account names and not edit them.
  4. In a three-tier environment, such as bots with Staging/Sandbox/Production modes, in Staging and Sandbox modes, you can add and edit new accounts. However, in Production, only the account details added in Staging will be available. You can only map in the production environment.

Event for receiving payment confirmation on the bot

Following are the events that are currently accommodated in the Integration:

Instamojo Payment StatusIn the case of payments the status can be checked with these details.

Please Activate the Instamojo Payment Status after configuring Instamojo credentials on the integration page.



If you have added multiple accounts in your platform, enable events for each of those accounts.

Use cases

Following are the use cases that are currently accommodated in the Integration:


When multiple accounts are added, select the appropriate account for each node, allowing you to leverage the unique functionalities of each account for their intended purposes.

Using the action nodes, you can generate payment links according to your use cases. Get the final amount from your cart total and call the Generate Payment link action node of integration.


Node Input Params

Field NameDescriptionSample Input
AmountThe amount for the request. The minimum amount is 9. The maximum is 200000200
Customer NameName of payerJohn
Customer EmailEmail of payer[email protected]
Customer Mobile NumberMobile no. of payer9999999999
PurposePurpose of the payment requestIphone
Send EmailFlag to send request link via email. If send_email is true, a request email will be sent to the email supplied. If send_email is true but no email is supplied, request creation will throw an errorFalse
Send SMSFlag to send request link via SMS. If send_sms is true, a request SMS will be sent to the phone number supplied. If send_sms is true but no phone number is supplied, request creation will throw an errorFalse
StatusCallbackUrlCopy Webhook URL from the Instamojo card at the integration page.Example:

Sample Success Response

"id": "05f317448ad84649aa1a9c7328edb015",
"user": "",
"phone": "+919999999999",
"email": "[email protected]",
"buyer_name": "John Doe",
"amount": "2500",
"purpose": "FIFA 16",
"status": "Pending",
"payments": [],
"send_sms": true,
"send_email": true,
"sms_status": "Pending",
"email_status": "Pending",
"shorturl": null,
"longurl": "",
"redirect_url": "",
"webhook": "",
"created_at": "2016-05-09T16:10:13.786Z",
"modified_at": "2016-05-09T16:10:13.786Z",
"resource_uri": "",
"allow_repeated_payments": false,
"mark_fulfilled": true

Create a Refund

This will refund a payment made on Instamojo.

Node Input Params

Field NameDescriptionSample Input
Refund AmountThis field can be used to specify the refund amount. For instance, you may want to issue a refund for an amount lesser than what was paid.200
Unique Transaction IDMandatory parameter in the body from the second case creation onwards for the payment to prevent duplicate case creations due to replay of APIsC5c0751269
Issue TypeA three-letter short code identifying the reason for this case. Please refer to the below table for this field's valueQFL
DescriptionAdditional text explaining the refundProduct is not good
Payment IdPayment Id received in create payment link node. store in database for further useMOJO5c04000J30502939

Valid values for different type

TNRProduct/service no longer available.
QFLCustomer not satisfied.
QNRProduct lost/damaged.
EWNDigital download issue.
TANEvent was canceled/changed.
PTHProblem not described above.
"refund": {
"id": "C5c0751269",
"payment_id": "MOJO5c04000J30502939",
"status": "Refunded",
"type": "QFL",
"body": "Customer isn't satisfied with the quality",
"refund_amount": "100",
"total_amount": "100.00",
"created_at": "2015-12-07T11:01:37.640Z"
"success": true


For more information about the action nodes you use here, refer to Create Payment, webhooks.