Sometimes it is required to get list of subscriptions with certain criteria. Zion today supports getting list through four parameters individually or together through simple HTTP GET method and query string. Merchant Id mandatory to fetch the list but other three can be used together as well to form desired query.
Post Method: GET
Path: {base_url}/api/sub/v1/merchant/subscriptions?
X-PayU-Subscription-Signature is SHA 512 signature used to provide security layer over existing APIs. Every API will have its own logic to generate X-PayU-Subscription- Signature logic. The following logic must be used:
Signature = SHA512("merchantId:" + merchantId + "|subscriptionId:" + subscriptionId + "|" + merchantSalt)Request parameters
| Parameter | Description |
|---|---|
merchantId mandatory | Merchant Key received during onboarding Sample Value - YQeVda |
skip | Skip is the number of subscriptions to be skip from the data-set fetched from database for given merchantId before applying the limit on it. |
limit | Number of subscriptions to be fetch. It should be greater than zero. Max value of limit is 20 |
status | Subscription status having possible values as |
subscriberEmail | Email id of the customer |
subscriberMobile | Mobile number of the customer |
Sample request
https://subscription.citruspay.com/api/sub/v1/merchant/subscriptions?merchantId=YQeV da&status=Enabled&skip=0&limit=15Sample response
{
"subscriptions": [
{
"subscriptionId": "5c97c51a652d405ed9834f58",
"createdDate": "2019-03-24T17:57:46.875Z",
"modifiedDate": "2019-03-24T18:33:46.406Z",
"subscriptionPlans": [
{
"planId": "ZION155345026687548",
"startDate": null,
"totalCount": 0,
"numberOfPaidInvoices": 0,
"numberOfInvoiceGenerated": 0,
"status": "Inactive",
"deleted": false,
"nextBillingDates": null,
"lastPaymentDates": null,
"billingInterval": 0,
"billingCycle": "ADHOC",
"planName": "Premium",
"amount": {
"value": 2,
"currency": "INR"
}
}
],
"authRefId": "7375340021",
"status": "Defined",
"subscriberEmail": "[email protected]",
"subscriberMobile": "9999999999",
"customParameter": {
"Policynumber": "12743123111",
"Policytype": "Life Insurance"
}
},
{
"subscriptionId": "5c95d46a2fc4f831c8b4ac1c",
"createdDate": "2019-03-23T06:38:34.828Z",
"modifiedDate": "2019-03-23T06:38:34.828Z",
"subscriptionPlans": [
{
"planId": "ZION155332311482827",
"startDate": "2019-03-26T11:00:00.000Z",
"totalCount": 5,
"numberOfPaidInvoices": 0,
"numberOfInvoiceGenerated": 0,
"status": "Inactive",
"deleted": false,
"nextBillingDates": null,
"lastPaymentDates": null,
"billingInterval": 1,
"billingCycle": "DAILY",
"planName": "Premium",
"amount": {
"value": 2,
"currency": "INR"
}
}
],
"authRefId": null,
"status": "Defined",
"subscriberEmail": "[email protected]",
"subscriberMobile": "9999999999",
"customParameter": {
"Policynumber": "12743123133",
"Policytype": "Terms Insurance"
}
},
{
"subscriptionId": "5c9517f2652d405ed9834f3f",
"createdDate": "2019-03-22T17:14:26.428Z",
"modifiedDate": "2019-03-22T17:14:26.428Z",
"subscriptionPlans": [
{
"planId": "ZION15532748664281",
"startDate": null,
"totalCount": null,
"numberOfPaidInvoices": 0,
"numberOfInvoiceGenerated": 0,
"status": "Inactive",
"deleted": false,
"nextBillingDates": null,
"lastPaymentDates": null,
"billingInterval": 1,
"billingCycle": "MONTHLY",
"planName": "Premium",
"amount": {
"value": 200,
"currency": "INR"
}
}
],
"authRefId": null,
"status": "Defined",
"subscriberEmail": "[email protected]",
"subscriberMobile": "9999999999",
"customParameter": {
"Policynumber": "12743123133",
"Policytype": "Terms Insurance"
}
}
],
"totalCount": 3,
"page": 1
}