---
title: Premium Balance Check API
description: This API will confirm policy premium and balance confirmation by Affiliate.
---

This API will confirm policy premium and balance confirmation by Affiliate. We must pass order id, amount and banktxnid in request. If the request has valid details, we will get a success response against the order id.

## POST

```
URL_to_be_provided_by_affiliate
```

## Header

| Field | Type | Description |
| --- | --- | --- |
| content-type | string | Value : application/x-www-form-urlencoded (required) |
| AFFKEY | string | Unique key for every affiliate. eg YWltdGM= (length 10) |
| AIRPAYKEY | string | Authentication key for airpay. Eg 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps (length 20, required) |
| CHECKSUM | string | Sha256 of value of hash(‘sha256’,’(oderid)(affiliateid)(ampunt)(companyid),AIRPAYKEY) (required) |

## Parameter

| Field | Type | Description |
| --- | --- | --- |
| orderid | Alphanumeric | Reference txnid shared by affiliatewhile initiating the transaction (length 20(fixed), required) |
| amount | Numeric | The premium amount that will be deducted by insurance company (length 10,2; required) |
| banktxnid | string | Bank transaction reference id(required) |
## Request-Example:

```
--header 'content_type: application/x-www-form-urlencoded' \
--header 'processor-key: xvAvkuxKczNf8sapHZv5ia9qzPEB9iPRvtLr4iJn4SzmMjfuWgVvSsXvyw==' \
--header 'checksum: d1e2629f8b5818all186a4b7d8e5d9a03b6aef297842ec571ad0cc2278bcfcf93' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: _csrf=103936bf3ssa2098165c59d08c9288e68459dcac60bba4d83cdb7c0a17163ea6a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22XORQcv-kviZ_teErDmi5drwuAhdUQpZE%22%3B%7D' \
--data-urlencode 'order_id=MAWEB107051612117107' \
--data-urlencode 'affiliate_id=AF0028SF1644819013' \
--data-urlencode 'amount=100.00' \
--data-urlencode 'banktxnid=ABCDXXXX'
```

## Success 200

| Field | Type | Description |
| --- | --- | --- |
| status | Numeric | Api status [1- success,0-fail](length 1) |
| data | Jsonarray | data provided will be with orderid |
| message | string | Message (length 50) |
## Success-Response:

```
{
    "status": "1",
    "data": [
        {
            "orderid": 12345678901234567000
        }
    ],
    "message": "success"
}
```
## [Error-Response:](https://sanctum.airpay.co.in/v3/#error-examples-INSURANCE-Premium_Balance_Check_API-1_0_0-0)

```
{
    "status": "0",
    "data": [
        {
            "orderid": 12345678901234567000
        }
    ],
    "message": "Duplicate Order"
}
```