Skip to main content


Version: 1.0

Get paid for your app by collecting a one time charge.

Webhooks for Subscription

You can register webhooks for specific shop events. For Subscription, the following webhook topic is available:

  • app_subscriptions/update: Triggered when the status of an app purchase one time is changed.

What you can do with Subscription

The Haravan API lets you do the following with the Subscription resource.


id : string

"id": "6141d6266e269fed5b515c89" 

The subscription ID of the application charge.

client_id : string

"client_id": "9ca6a90a2f50d894e6a123f5cd7ffa62"

The Client ID of the application.

created_at : string

"created_at": "2021-09-15T11:17:03.458Z"

The date and time (ISO 8601 format) when the application charge was created.

updated_at : string

"updated_at": "2021-09-15T11:17:03.458Z"

The date and time (ISO 8601 format) when the application charge was last updated.

expired_at : string

"expired_at": "2024-08-29T11:17:00Z"

The date and time (ISO 8601 format) when the application charge ends.

cancelled_at : string

"cancelled_at": null

The date and time (ISO 8601 format) when the merchant canceled their application charge.

Note: Returns null value when the application has not been canceled.

name : string

"name": "Promotion Bar"

The application name.

price : number

"price": 1200000

The price of the application.

plan_id : string

"plan_id": "plan_app_449_1713"

The plan id of the application.

quantity : number

"quantity": 1

The quantity of plan.

discount_amounts : number

"discount_amounts": 0

The discount applied to the price of the application.

total : number

"total": 1200000

The value of: price * quantity

amount_paid : number

"amount_paid": 1200000

The value of: total - discount_amounts

status : string

"status": "active"

The status of the application. Valid values:

  • active: Application fee has been paid.

  • canceled: The application has been canceled.

Example webhook:


Content-Type: application/json; charset=utf-8
X-Haravan-HmacSha256: t4mhmjWKTfHND1kC9nWFXtvKyOCYj3rUUycIfkKl6Cw=
X-Haravan-Topic: app_subscriptions/update
X-Haravan-Org-Id: 1000114691
X-Haravan-Subscription-Id: 6141d6266e269fed5b515c89

"id": "6141d6266e269fed5b515c89",
"client_id": "9ca6a90a2f50d894e6a123f5cd7ffa62",
"created_at": "2021-09-15T11:17:03.458Z",
"updated_at": "2021-09-15T11:17:03.458Z",
"expired_at": "2024-08-29T11:17:00Z",
"cancelled_at": null,
"name": "Promotion Bar",
"price": 1200000,
"plan_id": "plan_app_449_1713",
"quantity": 1,
"discount_amounts": 0,
"total": 1200000,
"amount_paid": 1200000,
"status": "active"


Retrieves a list of subscriptions


Retrieves a list of subscriptions.

  • GET
HTTP/1.1 200 OK

"app_subscriptions": [
"id": "61cec21e84b87c000192ec49",
"client_id": "6e6d****30a4",
"created_at": "2021-12-29T05:46:11.623Z",
"expired_at": "2022-01-13T05:46:11.623Z",
"updated_at": "2021-12-29T05:46:11.623Z",
"cancelled_at": null,
"total": 200000,
"amount_discount": 0,
"amount_paid": 200000,
"quantity": 1,
"status": "active",
"plan_id": "plan_app_2209_1793",
"name": "Hara Multi-language",
"price": 200000