---
title: Offers API
description: Verify unique IDs in offer URLs and retrieve coupon access details.
---

This API is triggered by the offers system to verify the unique ID in the offers URL for coupon access. When the URL loads, an API call is made to the affiliate callback URL to validate the ID. The response's "data" parameter provides transaction details, including the customer's name (displayed on the offers page) and the amount, which determines the number of coupons shown:

- Amount > 2000: 8 coupons.

- 2000 > Amount > 1000: 4 coupons.

- 1000 > Amount > 500: 2 coupons.

Otherwise, show the default token count.

If "expiryday" is present, use it as the expiry period; otherwise, use the standard expiry from affiliate data. Expiry day will be considered from the day of transaction datetime. The URL's accessibility period is set during affiliate onboarding.

#### POST

```
https://offers.airpay.co.in/app/<affiliatecode>/<uniqueid>
```

## Header

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| Content-Type  required | String | application/json |
| checksum  required | Text<br>(`64`) | Checksum value(length 64) hash('sha256',<affiliateid+airpaykey+allvalues>); | `91f5evhk72f5` |

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| affiliateid  required | String  <br>(10) | affilate identification code | `91fc5evhk7` |
| uniqueid  required | String | unique id entered in url in base64 format(max length 10) (required) |

## Success 200

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| status  required | Number | Sattus Code(400- fail,200-success)(required)(length 3) |
| message  required | String | Status Message(success,fail)(required) |
| data  required | json | Response data(required) Example: { "transactiontime":"Y:m:d H:i:s","customer":"ravi dubey","amount":"1000.00","expiryday":"4", } |
| checksum  required | String | Checksum value(required)(length 64) hash('sha256',<affiliateid+airpaykey+allvalues>); |

## Request Example

```
        curl --location --request POST '{{Affiliate Verification Url}}' \
        --header 'Content-Type: application/json' \
         --header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
        --data-raw '{
	            "affiliateid":"91fc5evhk7","uniqueid":"30912508233b7r37562g2hps"
         }'
```

### Success Response

```json
{
    "status": 200,
    "message": "success",
    "data": {
        "transactiontime": "2021-04-18 00:00:00",
        "customer": "ravi dubey",
        "amount": "1000.00",
        "expiry": "72"
    },
    "checksum": "91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps"
}
```