In the world of crypto payments, having the right address to receive funds is crucial. That's where BlockchainAccounts come in. Let's dive into how you can set up and manage these essential components of your Portal Pay integration.

Endpoints

Portal Pay provides three key endpoints for managing your BlockchainAccounts:

Create a new account: POST /flow/blockchain-accounts
Retrieve account details: GET /flow/blockchain-accounts/{id}
Remove an account: DELETE /flow/blockchain-accounts/{id}

What is a BlockchainAccount?

Think of a BlockchainAccount as a designated mailbox for a specific cryptocurrency. It tells Portal Pay where to direct customer payments for each blockchain you support.

❗️
is_default:
We strongly recommend creating a BlockchainAccount for every blockchain you want to accept payments on, with is_default set to True. This ensures smooth operations unless you're planning to split payments across multiple accounts.

Key Features

Default Accounts: Setting is_default to True makes an account the go-to destination for a specific blockchain.
Multiple Accounts: You can have several accounts per blockchain, useful for advanced payment routing.
Automatic Selection: If you have multiple non-default accounts, we'll randomly choose one for each transaction.

Special Considerations for Bitcoin

Bitcoin works a bit differently. Here's what you need to know:

You'll need to provide an xpub or zpub (extended public key) to Portal Pay.
We use this to generate a unique receiving address for every TransactionRequest.
The derivation path we use is m/84'/0'/0'.

This approach enhances privacy and makes transaction tracking easier.