POLi - Custom Integration

Prerequisites

Sign up
for a Razorpay account.
Generate API Keys
from the Dashboard.
Integrate Razorpay Custom Checkout on your
website
,
Android app
or
iOS App
.

Integrate POLi on Custom Checkout

Create an Order.
Pass method and provider parameters in
Create Payment Method
.

Create an Order

Order is an important step in the payment process.

An order should be created for every payment.
You can create an order using the
Orders API
. It is a server-side API call. Know how to
authenticate
Orders API.
Pass the order_id received in response to the checkout. This ties the Order with the payment and secures the request from being tampered.

API Sample Code

The following is a sample API request and response for creating an order:

curl -X POST https://api.razorpay.com/v1/orders
-u [YOUR_KEY_ID]:[YOUR_KEY_SECRET]
-H 'content-type:application/json'
-d '{
    "amount": 50000,
    "currency": "INR",
    "receipt": "rcptid_11"
}'

Request Parameters

Here is the list of parameters and their description for creating an order:

amount

mandatory

integer The transaction amount, expressed in the currency subunit. For example, for an actual amount of $299.35 , the value of this field should be 29935.

currency

mandatory

string The currency in which the transaction should be made. Length must be 3 characters.

receipt

optional

string Your receipt id for this order should be passed here. Maximum length is 40 characters.

notes

optional

json object Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

partial_payment

optional

boolean Indicates whether the customer can make a partial payment. Possible values:

true: The customer can make partial payments.
false (default): The customer cannot make partial payments.

mandatory

string Unique identifier of the customer. For example, cust_1Aa00000000004.

Know more about

Orders API

Error Response Parameters

The error response parameters are available in the

API Reference Guide

Pass method and provider Parameters During Payment Creation

The following is a sample API to create a payment.

razorpay.createPayment({
  "amount": 500,
  "currency": "INR",
  "email": "gaurav.kumar@example.com",
  "contact": 9111145678,
  "order_id": "order_EAbtuXPh24LrEc",
  "method": "app",
  "provider": "poli"
});

{
  "razorpay_payment_id": "pay_xxxx",
  "next": [
    {
      "action": "poll",
      "url": "https://api.razorpay.com/v1/payments/pay_xxx/status"
    }
  ]
}

Request Parameters

Along with the other checkout options, you must pass:

method

mandatory

string The method used to make the payment. Here, it should be app.

provider

mandatory if method=app

string Name of the PSP app. Here, it should be poli.