Subscriptions

Subscriptions allow you to charge customers on a recurring basis. Customers can subscribe through 8Pay’s hosted checkout pages that can be reached by embedded buttons, short urls and QR codes.

Statuses

Subscriptions can be in four different statuses:

  • ACTIVE: the current cycle was paid

  • EXPIRED: the latest cycle is over, a payment is due for the next one

  • CANCELLED: the subscription was cancelled by the user

  • TERMINATED: the subscription was terminated by the vendor

Get a list of subscriptions

GET https://api.8pay.network/v1/:chain/fixed-recurring/subscriptions

Path Parameters

Name
Type
Description

chain

string

Query Parameters

Name
Type
Description

user

string

filter by user

status

string

filter by status (ACTIVE, EXPIRED, CANCELLED or TERMINATED)

from

number

filter by subscribedAt (default 0)

to

number

filter by subscribedAt (default current timestamp)

sortBy

string

order by subscribedAt, cycleStart or cycleEnd (default subscribedAt)

sort

string

asc or desc (default desc), sort based on sortBy query parameter

Headers

Name
Type
Description

Authorization

string

Bearer <api-key>

{
    "data": [
        {
            "id": "0xe63ba761797e289076f80a7c0916a31740684806aaf507da85f81ee785fec6ba",
            "user": "0x16F37b6c96C7038f3E4CDd7aAF9c9A8EC49c4EE7",
            "planId": "0x57b2059e526841b3dfd964144513359c9fcfd6d91040b6c47f589c1e032b6bf7",
            "status": "ACTIVE",
            "subscribedAt": 1571646052,
            "cycleStart": 1571646052,
            "cycleEnd": 1574238052,
            "transactionHash": "0xbb97a142aed61a7027b0a030f3c0ab7e1b39bb776201752829d96d562ed49782",
            "transactionStatus": "confirmed"
        }
    ],
    "limit": 100,
    "offset": 0,
    "total": 1
}

Get subscriptions of a plan

GET https://api.8pay.network/v1/:chain/fixed-recurring/plans/:planId/subscriptions

Path Parameters

Name
Type
Description

planId

string

ID of the plan

chain

string

Query Parameters

Name
Type
Description

user

string

filter by user

status

string

filter by status (ACTIVE, EXPIRED, CANCELLED or TERMINATED)

from

number

filter by subscribedAt (default 0)

to

number

filter by subscribedAt (default current timestamp)

sortBy

string

order by subscribedAt, cycleStart or cycleEnd (default subscribedAt)

sort

string

asc or desc (default desc), sort based on sortBy query parameter

Headers

Name
Type
Description

Authorization

string

Bearer <api-key>

{
    "data": [
        {
            "id": "0xe63ba761797e289076f80a7c0916a31740684806aaf507da85f81ee785fec6ba",
            "user": "0x16F37b6c96C7038f3E4CDd7aAF9c9A8EC49c4EE7",
            "planId": "0x57b2059e526841b3dfd964144513359c9fcfd6d91040b6c47f589c1e032b6bf7",
            "status": "ACTIVE",
            "subscribedAt": 1571646052,
            "cycleStart": 1571646052,
            "cycleEnd": 1574238052,
            "transactionHash": "0xbb97a142aed61a7027b0a030f3c0ab7e1b39bb776201752829d96d562ed49782",
            "transactionStatus": "confirmed"
        }
    ],
    "limit": 100,
    "offset": 0,
    "total": 1
}

Get a subscription

GET https://api.8pay.network/v1/:chain/fixed-recurring/subscriptions/:subscriptionId

Path Parameters

Name
Type
Description

subscriptionId

string

ID of the subscription

chain

string

Headers

Name
Type
Description

Authorization

string

Bearer <api-key>

{
    "id": "0xe63ba761797e289076f80a7c0916a31740684806aaf507da85f81ee785fec6ba",
    "user": "0x16F37b6c96C7038f3E4CDd7aAF9c9A8EC49c4EE7",
    "planId": "0x57b2059e526841b3dfd964144513359c9fcfd6d91040b6c47f589c1e032b6bf7",
    "status": "ACTIVE",
    "subscribedAt": 1571646052,
    "cycleStart": 1571646052,
    "cycleEnd": 1574238052,
    "transactionHash": "0xbb97a142aed61a7027b0a030f3c0ab7e1b39bb776201752829d96d562ed49782",
    "transactionStatus": "confirmed"
}

Last updated