Create

Creates a recurring profile: the agreement of the client to be charged later without confirming every payment.

Supported payment systems: Bybit Pay and Binance Pay.

Give the client url from the response: the client confirms the profile in the app of the payment system.

After the confirmation the profile becomes active: charge it with Execute.

Follow the status with notifications to state_callback (Notify) or with Info.

Recurring profile flow

Result

HTTP	Body	Meaning	Next step
`201`	`profile_id`, `url`	The profile is created with the status `process`.	Give the client `url`.
`201`	`profile_id`, `error`	The payment system rejected the profile.	See `error`; check the profile with Info.
`400`, `401`, `422`, `500`	—	The request is rejected.	See «Errors» below.

Errors

The error is returned in error_description; error_code is returned for 401, 422 and for the 400 errors that have a code below.

HTTP	`error_code`	When	What to do
`400`	`3004`	The invoice type or the agreement type does not support recurring payments.	Use `bybit` or `binance`.
`401`	`9998`	The signature is invalid.	Check the signature: see Overview.
`422`	`9403`	The X-JWS-Signature header is missing.	Pass the signature.
`500`	—	A field is missing or invalid. `error_description` names the field.	Fix the request.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "invoice_type": "binance",
    "external_id": "sub1001",
    "agreement_type": "on-demand",
    "additional": {
        "scene_code": "SUBSCRIPTION"
    },
    "state_callback": "https://merchant.example.com/callback",
    "expires_at": "2027-04-30"
}

Responses

🟢201Created

application/json

Headers

Bodyapplication/json

Example

{
    "profile_id": "9f8e7d6c5b4a39281706f5e4d3c2b1a0",
    "url": "bnc://app.binance.com/mp/app?appId=A1b2C3d4E5f6G7h8&startPagePath=cGFnZXMvY29udHJhY3Qtc2lnbi9pbmRleA&startPageQuery=cHJlQ29udHJhY3RJZD0xMjM0NTY3ODk",
    "created_at": "2026-10-30T13:48:47+05:00"
}

🟠400Bad Request

🟠401Unauthorized

🟠422Unprocessable Entity

🔴500Internal Server Error

Recurring profile flow#

Result#

Errors#

Request

Responses

Recurring profile flow

Result

Errors