Introducing Instamojo’s Marketplace API

Bringing more flexibility & control to marketplace owners. Split and disburse payments, Charge commission fees. add custom payout rules & so much more.

Please enter valid email id

please reach out to “Instamojo support” to receive market place credentials.

Instamojo marketplace api

With Marketplace APIs, you can now fully automate payments on your marketplace. No nodal accounts. No infra setup. No maintenance charges.

Instamojo Marketplace API Features

Features
Of Marketplace API

Fully customisable API that offers more control & flexibility to your Marketplace’s payment processes.

  • Allows third party vendors to sell products on the marketplace platform
  • Auto creates and manages vendor accounts via API
  • Collects payment from the end customers on behalf of the vendors
  • Split and distribute payments between multiple accounts/vendors
  • Auto calculates marketplace owner’s commission on every product sold

please reach out to “Instamojo support” to receive market place credentials.

Manage Payouts Via API

Completely API driven approach for managing all your marketplace payments.

Manage Settlements

Settle incoming payments easily with the third party vendors at scheduled times or defer them until your business conditions are met.

Safe & Secure

Instamojo’s marketplace API complies with updated and advanced safety and privacy regulations to protect your merchants’ transactions.

Light Checkout

Integrate the payment checkout seamlessly without having the customers leaving your website.

Process Refunds

Issue full refunds and partial refunds easily for
the corresponding payments.

Marketplace API

Snapshot of Marketplace APIs

Body Params

grant_type required

string client_credentials

This describes the type of authentication.

client_id required

string client_credentials

The client_id that is provided to you.

client_secret required

string client_credentials

The client_secret that is provided to you.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
$payload = Array(
'grant_type' => 'client_credentials',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

Body Params

grant_type required

string password

This describes the type of authentication

client_id required

string

The client_id that is provided to you.

client_secret required

string

The client_secret that is provided to you.

username required

string

Email or Username of the user.

password required

string

Password of the user.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);

$payload = Array(
'grant_type' => 'password',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F',
'username' => 'foo@example.com',
'password' => 'bar'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

Body Params

grant_type required

string refresh_token

This describes the type of authentication.

client_id required

string

The client_id that is provided to you.

client_secret required

string

The client_secret that is provided to you.

refresh_token required

string

The refresh_token obtained from User Based Authentication.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);

$payload = Array(
'grant_type' => 'refresh_token',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F',
'refresh_token' => 'oPorohVcpY5n7v7cS8biUKQZcvV5fT'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

Body Params

email required

string

Email id for the account.

password

string

Phone number for the account.

phone

string

Phone number for the account

referrer

string

The referrer provided to you.

PHP
Python
cURL
<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer y70kak2K0Rg7J4PAL8sdW0MutnGJEl'));

$payload = Array(
'email' => 'foo@example.com',
'password' => 'bar',
'phone' => '919988776655',
'referrer' => 'value-provided-to-you-by-instamojo'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Body Params

first_name

string

First name of the account.

last_name

string

Last name of the account.

location

string

Location of the user.

phone

string

Phone number of the user.

PHP
Python
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/90f01dfdacbe4fe7892fc27dbdc30906/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzF0DzbP5jIKZk8gJO0mOr4W0t'));

$payload = Array(
'first_name' => 'Foo',
'last_name' => 'Bar',
'location' => 'India',
'phone' => '+919988776655'
);

curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
curl_close($ch);

?>

Body Params

account_holder_name required

string

Name of account holder.

account_number

string

Bank account number.

ifsc_code

string

IFSC code of the branch.

PHP
Python
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/90f01dfdacbe4fe7892fc27dbdc30906/inrbankaccount/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzF0DzbP5jIKZk8gJO0mOr4W0t'));

$payload = Array(
'account_holder_name' => 'Foo Bar',
'account_number' => '123456789',
'ifsc_code' => 'SBIN0000111'
);

curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Body Params

buyer_name required

string

Name of payer

email required

string

Email of payer

phone required

string

Phone number of payer.

purpose required

string

Purpose of the payment request.

amount required

string double

The amount for the request. The minimum amount is 9. And the maximum is 200000.

PHP
Python
<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/payment_requests/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzFODibP5jIKVk8gJO0NOr4W0t'));

$payload = Array(
'purpose' => 'FIFA 16',
'amount' => '2500',
'buyer_name' => 'John Doe',
'email' => 'foo@example.com',
'phone' => '9999999999',
'redirect_url' => 'http://www.example.com/redirect/',
'send_email' => 'True',
'send_sms' => 'True',
'webhook' => 'http://www.example.com/webhook/',
'allow_repeated_payments' => 'False',
}

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Snapshot of Marketplace APIs

Application Based Authentication

Body Params

grant_type required

string client_credentials

This describes the type of authentication.

client_id required

string client_credentials

The client_id that is provided to you.

client_secret required

string client_credentials

The client_secret that is provided to you.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
$payload = Array(
'grant_type' => 'client_credentials',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

User Based Authentication

Body Params

grant_type required

string password

This describes the type of authentication

client_id required

string

The client_id that is provided to you.

client_secret required

string

The client_secret that is provided to you.

username required

string

Email or Username of the user.

password required

string

Password of the user.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);

$payload = Array(
'grant_type' => 'password',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F',
'username' => 'foo@example.com',
'password' => 'bar'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

Refresh Token Based Authentication

Body Params

grant_type required

string refresh_token

This describes the type of authentication.

client_id required

string

The client_id that is provided to you.

client_secret required

string

The client_secret that is provided to you.

refresh_token required

string

The refresh_token obtained from User Based Authentication.

PHP
Python
cURL
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/oauth2/token/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);

$payload = Array(
'grant_type' => 'refresh_token',
'client_id' => '21fe14a60057ece6c76496175cb0238a2ffd87be',
'client_secret' => '-KWPoDO!_l?MZQ-DsZeQ0TXXcvuDn;mxmAtGho8Xijn=iH6F',
'refresh_token' => 'oPorohVcpY5n7v7cS8biUKQZcvV5fT'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

Signup

Body Params

email required

string

Email id for the account.

password

string

Phone number for the account.

phone

string

Phone number for the account

referrer

string

The referrer provided to you.

PHP
Python
cURL
<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer y70kak2K0Rg7J4PAL8sdW0MutnGJEl'));

$payload = Array(
'email' => 'foo@example.com',
'password' => 'bar',
'phone' => '919988776655',
'referrer' => 'value-provided-to-you-by-instamojo'
);

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Update details of a user

Body Params

first_name

string

First name of the account.

last_name

string

Last name of the account.

location

string

Location of the user.

phone

string

Phone number of the user.

PHP
Python
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/90f01dfdacbe4fe7892fc27dbdc30906/');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PATCH');
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzF0DzbP5jIKZk8gJO0mOr4W0t'));

$payload = Array(
'first_name' => 'Foo',
'last_name' => 'Bar',
'location' => 'India',
'phone' => '+919988776655'
);

curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
$response = curl_exec($ch);
curl_close($ch);

?>

Update bank details of a user

Body Params

account_holder_name required

string

Name of account holder.

account_number

string

Bank account number.

ifsc_code

string

IFSC code of the branch.

PHP
Python
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/users/90f01dfdacbe4fe7892fc27dbdc30906/inrbankaccount/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzF0DzbP5jIKZk8gJO0mOr4W0t'));

$payload = Array(
'account_holder_name' => 'Foo Bar',
'account_number' => '123456789',
'ifsc_code' => 'SBIN0000111'
);

curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Create a Payment Request

Body Params

buyer_name required

string

Name of payer

email required

string

Email of payer

phone required

string

Phone number of payer.

purpose required

string

Purpose of the payment request.

amount required

string double

The amount for the request. The minimum amount is 9. And the maximum is 200000.

PHP
Python
<?php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.instamojo.com/v2/payment_requests/');
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
curl_setopt($ch, CURLOPT_HTTPHEADER,array('Authorization: Bearer n9kmKzFODibP5jIKVk8gJO0NOr4W0t'));

$payload = Array(
'purpose' => 'FIFA 16',
'amount' => '2500',
'buyer_name' => 'John Doe',
'email' => 'foo@example.com',
'phone' => '9999999999',
'redirect_url' => 'http://www.example.com/redirect/',
'send_email' => 'True',
'send_sms' => 'True',
'webhook' => 'http://www.example.com/webhook/',
'allow_repeated_payments' => 'False',
}

curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($payload));
$response = curl_exec($ch);
curl_close($ch);

?>

Benefits Of Marketplace APIs

Marketplace API

Auto Transfers

Auto transfer each individual payment any number of times to multiple vendors. 

instamojo capital for business loans

Invoices

Send your vendors GST compliant invoices with our Invoice generator app. 

Settlements

Manage settlements with periodic & custom payouts – complete control over payouts. 

Pay Only On Successful Transactions

No Setup Fee. No Maintenance Charges. No Minimum Commitment.

Marketplace API

Why Businesses Instamojo

Shriyans Bhandari Greensole

Instamojo is the first company through which we took our recycled footwear online. We can just share a link or even ask for a particular amount from customers and donors. It is a very transparent process and is helping us a lot.

Shriyans Bhandari

CEO and Co founder, Greensole

Marketplace API

For over a year, we tested Quirksmith through flea markets and we relied completely on Instamojo for payments and product listings. I often read the blogs they send across and find them very helpful in business.

Pragya Batra

Co founder, QuirkSmith Jewelry

Marketplace API

I can’t tell you what a big difference Instamojo has made to our business because it has streamlined the process so much. The interface is very easy for even those who are not very comfortable on the internet.

Nisha Millet

Director, Swimming Academy

Marketplace API

We find instamojo to be very intuitive and therefore easy to use. It is a simple product that directly addresses the expectation of a payment gateway. The ability to create links on the go, and share with our guests has helped us receive payments.

Vinay Kumar

Founder & Director, InsightsIAS

Get FREE ebook on "Secrets To Multiplying Your Sales Online" our fortnightly newsletter on SME news & tips for Indian businesses

instamojo logo
ebook instamojo

 Growth Hacks

Free

Your subscription could not be saved. Please try again.
Your subscription has been successful.