Account-Specific Paylinks
Account-Specific Paylinks is a feature designed for merchants who manage multiple accounts across different currencies, payment chains, or geographic regions. This feature allows merchants to link specific accounts to their paylinks, giving them greater control and flexibility over payment settlements. It is ideal for platforms handling large volumes of accounts, allowing customization of how each payment is directed to specific accounts.
Who Is This Feature For?
This feature is designed for platforms and businesses that:
- Manage Multiple Merchants: Account-specific Paylinks allow you to direct payments to the correct merchant accounts if you oversee payments for numerous merchants.
- Require Granular Control: Businesses needing precise control over which accounts are used for specific transactions.
- Operate Across Various Chains and Currencies: If your platform handles payments in multiple chains and currencies, associating accounts ensures the correct handling of each transaction.
How to Use Account-Specific Paylinks
To create an account-specific paylink, merchants have two primary options for associating accounts:
Account Creation
Refer to the Configuring Accounts with BoomFi's API guide to learn how to create and manage your accounts.
account_ids
account_ids
The account_ids
parameter lets you specify an array of account IDs directly in the paylink request. This is useful if you have exact accounts in mind that should receive the payment. Using the Create Paylink endpoint, add the account IDs array to the request, as exemplified below:
curl --request POST \
--url https://mapi.boomfi.xyz/v1/paylinks \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"name": "My New Paylink",
"amount": "100",
"currency": "USD",
"account_ids": [
1,
2,
3
]
}
'
account_ref
account_ref
The account_ref
parameter allows you to associate a general account reference with the paylink. This option helps group multiple accounts under a shared reference, making it more straightforward to attach a category of accounts rather than specific IDs. Using the Create Paylink endpoint, add the account reference to the request, as exemplified below:
curl --request POST \
--url https://mapi.boomfi.xyz/v1/paylinks \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"name": "My New Paylink",
"amount": "100",
"currency": "USD",
"account_ref": "my_acc_reference"
}
'
Things to Keep in Mind
- Self-Management Is Key: Choosing this granular approach means you are responsible for managing all aspects of your accounts and Paylinks.
- Flexibility vs. Complexity: While this feature offers great flexibility, it also requires diligent management to ensure everything operates smoothly.
Updated about 1 month ago