REST API

The Ippopay Payments plugin allows you to accept credit card, UPI, Netbanking and debit card payments via Ippopay payment gateway.
post
Create Order
https://public_key:[email protected]/v1/order/create
Use this api to create your order on Ippopay to use it for initiating transaction. You can get your keys from the api dashboard.
Request
Response
Request
Body Parameters
notify_url
optional
string
Your webhook url
amount
required
number
The Order amount to be charged in format ##.##
currency
optional
string
The currency to be charged, Defaults to INR.
payment_modes
optional
string
Payment modes to be enabled for this order, Defaults to Credit, Debit Cards, Netbanking and UPI.
customer
optional
object
Information of the customer, if not provided will be prompted on payment page.
Response
200: OK
{
        "success": true,
        "message": "Order created",
        "data": {
            "order": {
            "merchant": {
                "name": "Demo Merchant",
                "id": "TaodSgGa"
            },
            "customer": {
                "phone": {
                "country_code": "91",
                "national_number": "1234567"
                },
                "name": "Test",
                "email": "[email protected]"
            },
            "currency": "INR",
            "paymentModes": "cc,db,nb,upi",
            "status": "created",
            "amount": 100.00,
            "order_id": "[email protected]"           
            }
        }
    }
​
{
        "amount": 100.00,
        "currency": "INR",
        "payment_modes": "cc,dc,nb,upi",
        "notify_url":"YOUR WEBHOOK URL",
        "customer": {
                "name": "Test",
                "email": "[email protected]",
                "phone": {
                        "country_code": "91" ,
                        "national_number": "1234567"
                    }
                }
    }
​
get
Get Order Details
https://public_key:[email protected]/v1/order/ORDER_ID
Use this API to get your order details.
Request
Response
Request
​
Response
200: OK
{
        "success": true,
        "message": "Order Details",
        "data": {
            "order": {
            "merchant": {
                "name": "Demo Merchant",
                "id": "TaodSgGa"
            },
            "customer": {
                "phone": {
                "country_code": "91",
                "national_number": "1234567"
                },
                "name": "Test",
                "email": "[email protected]"
            },
            "currency": "INR",
            "paymentModes": "cc,db,nb,upi",
            "status": "created",
            "amount": 100.00,
            "order_id": "[email protected]", 
            "payment_url": "https://pay.ippopay.com/order/[email protected]",
           
            }
        }
    }
​
get
Get Transaction Details for Order
https://public_key:[email protected]/v1/order/ORDER_ID/transaction
Use this API to get your transaction details for the successful order.
Request
Response
Request
​
Response
200: OK
{
    "success":true,
    "message":"Transaction details",
    "data":{
        "transaction":{
            "trans_id":"trans_t2Jca2dVIF",
            "merchant":{
                "name":"Test",
                "id":"MERCHANT_ID"
            },
            "customer":{
                "phone":{
                    "country_code":"+91",
                    "national_number":"9876543210"
                },
                "name":"Test",
                "email":"[email protected]"
            },
            "cost":{
                "paid":1,
                "settled":0.98
            },
            "commission":{
                "percentage":1.75,
                "value":0.02,
                "tax":0,
                "total":0.02,
            },
            "tax":{
                "value":0,
                "calculation":"percent"
            },
            "notes":"",
            "is_manual_record":false,
            "manual_recorded_date":"2020-12-08T17:33:11.405Z",
            "is_intl_payment":false,
            "refund_status":"not_requested",
            "status":"success",
            "failure_reason":"",
            "product":"order",
            "settlement_date":"2020-12-10T18:30:00.000Z",
            "gateway":{
                "payment_mode":{
                    "pay_mode":"Debit Card",
                    "pay_mode_id":"dc",
                    "pay_group":"card",
                    "bank_name":"HDFC Bank",
                    "card_number":"405988XXXXXX6908",
                    "card_scheme":"VISA"
                }
            },
            "updatedAt":"2020-12-09T06:59:23.488Z",
            "createdAt":"2020-12-09T06:59:23.488Z",
            "settlement_id":"settl_oVHAVByLh"
        }
    }
}
​
post
Refund Request
https://public_key:[email protected]/v1/order/refund/YOUR_ORDER_ID
Use this API to refund for your order on Ippopay.
Request
Response
Request
Body Parameters
refund_amt
optional
number
Pass this parameter to do a partial refund. 
Response
200: OK
{
    "success": true,
    "message": "Your refund request accepted"
}
​
​
PHP Integration
Next - Server Side Integrations
PHP Client
Last updated 3 weeks ago
REST API

postCreate Order

getGet Order Details

getGet Transaction Details for Order

postRefund Request

post
Create Order

get
Get Order Details

get
Get Transaction Details for Order

post
Refund Request
