adyen.com – BalancePlatformService
The Configuration API enables you to create a platform where you can onboard your users as account holders and create balance accounts, cards, and business accounts.
Authentication
Your Adyen contact will provide your API credential and an API key. To connect to the API, add an X-API-Key header with the API key as the value, for example:
Alternatively, you can use the username and password to connect to the API using basic authentication. For example:
Versioning
The Configuration API supports using a version suffix in the endpoint URL. This suffix has the following format: "vXX", where XX is the version number.
For example:
Going live
When going live, your Adyen contact will provide your API credential for the live environment. You can then use the API key or the username and password to send requests to https://balanceplatform-api-live.adyen.com/bcl/v2.
curl-H "Content-Type: application/json" \-H "X-API-Key: YOUR_API_KEY" \...curl-H "Content-Type: application/json" \-U "ws@BalancePlatform.YOUR_BALANCE_PLATFORM":"YOUR_WS_PASSWORD" \...https://balanceplatform-api-test.adyen.com/bcl/v2/accountHolders- Homepage
- https://api.apis.guru/v2/specs/adyen.com:BalancePlatformService/2.json
- Provider
- adyen.com:BalancePlatformService / BalancePlatformService
- OpenAPI version
- 3.1.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/adyen.com/BalancePlatformService/2/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/adyen.com/BalancePlatformService/2/openapi.yaml
Tools (33)
Extracted live via the executor SDK.
-
accountHolders.getAccountHoldersIdReturns an account holder.
-
accountHolders.getAccountHoldersIdBalanceAccountsReturns a paginated list of the balance accounts associated with an account holder. To fetch multiple pages, use the query parameters.
For example, to limit the page to 5 balance accounts and skip the first 10, use
/accountHolders/{id}/balanceAccounts?limit=5&offset=10. -
accountHolders.patchAccountHoldersIdUpdates an account holder. When updating an account holder resource, if a parameter is not provided in the request, it is left unchanged.
-
accountHolders.postAccountHoldersCreates an account holder linked to a .
-
balanceAccounts.deleteBalanceAccountsBalanceAccountIdSweepsSweepIdDeletes a sweep for a balance account.
-
balanceAccounts.getBalanceAccountsBalanceAccountIdSweepsReturns a list of the sweeps configured for a balance account.
To fetch multiple pages, use the query parameters. For example, to limit the page to 5 sweeps and to skip the first 10, use
/balanceAccounts/{balanceAccountId}/sweeps?limit=5&offset=10. -
balanceAccounts.getBalanceAccountsBalanceAccountIdSweepsSweepIdReturns a sweep.
-
balanceAccounts.getBalanceAccountsIdReturns a balance account and its balances for the default currency and other currencies with a non-zero balance.
-
balanceAccounts.getBalanceAccountsIdPaymentInstrumentsReturns a paginated list of the payment instruments associated with a balance account.
To fetch multiple pages, use the query parameters.For example, to limit the page to 3 payment instruments and to skip the first 6, use
/balanceAccounts/{id}/paymentInstruments?limit=3&offset=6. -
balanceAccounts.patchBalanceAccountsBalanceAccountIdSweepsSweepIdUpdates a sweep. When updating a sweep resource, note that if a request parameter is not provided, the parameter is left unchanged.
-
balanceAccounts.patchBalanceAccountsIdUpdates a balance account.
-
balanceAccounts.postBalanceAccountsCreates a balance account that holds the funds of the associated account holder.
-
balanceAccounts.postBalanceAccountsBalanceAccountIdSweepsCreates a sweep that results in moving funds from or to a balance account.
A sweep pulls in or pushes out funds based on a defined schedule, amount, currency, and a source or a destination.
-
bankAccountValidation.postValidateBankAccountIdentificationValidates bank account identification details. You can use this endpoint to validate bank account details before you or .
-
grantAccounts.getGrantAccountsIdReturns the details of the .
-
grantOffers.getGrantOffersReturns a list of all available for
accountHolderIdspecified as a query parameter. -
grantOffers.getGrantOffersGrantOfferIdReturns the details of a single grant offer.
-
paymentInstrumentGroups.getPaymentInstrumentGroupsIdReturns the details of a payment instrument group.
-
paymentInstrumentGroups.getPaymentInstrumentGroupsIdTransactionRulesReturns a list of all the transaction rules associated with a payment instrument group.
-
paymentInstrumentGroups.postPaymentInstrumentGroupsCreates a payment instrument group to associate and group payment instrument resources together. You can apply a transaction rule to a payment instrument group.
-
paymentInstruments.getPaymentInstrumentsIdReturns the details of a payment instrument.
-
paymentInstruments.getPaymentInstrumentsIdRevealReturns the primary account number (PAN) of a payment instrument.
To make this request, your API credential must have the following :
- Balance Platform BCL PCI role
-
paymentInstruments.getPaymentInstrumentsIdTransactionRulesReturns a list of transaction rules associated with a payment instrument.
-
paymentInstruments.patchPaymentInstrumentsIdUpdates a payment instrument. Once a payment instrument is already active, you can only update its status. However, for cards created with inactive status, you can still update the balance account associated with the card.
-
paymentInstruments.postPaymentInstrumentsCreates a payment instrument to issue a physical card, a virtual card, or a business account to your user.
For more information, refer to or .
-
platform.getBalancePlatformsIdReturns a balance platform.
-
platform.getBalancePlatformsIdAccountHoldersReturns a paginated list of all the account holders that belong to the balance platform. To fetch multiple pages, use the query parameters.
For example, to limit the page to 5 account holders and to skip the first 20, use
/balancePlatforms/{id}/accountHolders?limit=5&offset=20. -
transactionRules.deleteTransactionRulesTransactionRuleIdDeletes a transaction rule.
-
transactionRules.getTransactionRulesTransactionRuleIdReturns the details of a transaction rule.
-
transactionRules.patchTransactionRulesTransactionRuleIdUpdates a transaction rule.
-
To update only the status of a transaction rule, send only the
statusparameter. All other parameters not provided in the request are left unchanged. -
When updating any other parameter, you need to send all existing resource parameters. If you omit a parameter in the request, that parameter is removed from the resource.
-
-
transactionRules.postTransactionRulesCreates a . When your user makes a transaction with their Adyen-issued card, the transaction is allowed or declined based on the conditions and outcome defined in the transaction rule. You can apply the transaction rule to several cards, such as all the cards in your platform, or to a specific card. For use cases, see .
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools