This endpoint allows you to create a sub-account entry which will be stored under your main account and connected to your API key. This is useful when it comes to tracing where the payments originate from in case you have multiple merchant websites or stores creating payments with your API key.

👍
Webhook URL per Sub-account:
It is possible to set up a unique Webhook URL per created Subaccount. If you need this setup, please reach out to support@coinify.com with your request and provide us the following information for each subaccount webhook URL setup:

Sub-account ID (See Read Sub-account data or List all Sub-accounts to fetch your existing Sub-account IDs)

Webhook URL for the specific Sub-account

Shared secret for the specific Webhook URL (alternatively, we can set up the shared secret on our end and share it with you.

❗️
**Make sure to communicate Shared secrets via secure channels. **

To receive a Payment Intent related webhook event to a specific Webhook URL that you set for a sub-account, you must specify the relevant subaccountId on the Payment Intent creation.

📘
Note that if you set up a webhook URL on your main account together with subaccount specific webhooks, the webhook on your main account will receive all webhook events traffic, regardless of which subaccountId you specify on a particular Payment Intent.

201201

422422