> ## Documentation Index > Fetch the complete documentation index at: https://docs.dintero.com/llms.txt > Use this file to discover all available pages before exploring further. # Initiate fund transfer > You can use the endpoint to programmatically initiate a fund transfer between two sellers Requests for fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result in the settlement report ## OpenAPI ````yaml /mintlify-docs/openapi/spec-payout.yaml post /v2/accounts/{aid}/payout/fund-transfers openapi: 3.0.0 info: title: Payout API contact: name: API Integration Support email: integration@dintero.com description: > API for the payout service # Changelog All notable changes to the API. ## 2025-10-21 new: Generate proposals > - [POST /v/accounts/{aid}/payout/admin/payout/generate-proposals](/payout-api/admin-proposal/aid_admin_proposals_generate) ## 2025-06-26 new: Fail a proposal-item > - [POST /v/accounts/{aid}/payout/admin/payout/proposal-item/{proposal-item-id}/fail](/payout-api/admin-proposal/aid_admin_proposal_item_fail) ## 2025-05-01 new: Add support for new block rule types `owner-orgno` and `owner-verified-id` > > - [GET /v/accounts/{aid}/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rules_get) > - [POST /v/accounts/{aid}/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rule_post) > - [GET /v/accounts/{aid}/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_get) > - [PATCH /v/accounts/{aid}/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_patch) > - [POST /v/accounts/{aid}/payout/admin/block-rules-test](/payout-api/admin-block-rule/aid_admin_block_rule_test) ## 2025-02-20 new: Add support for `payout_minimum_amount` configuration to limit payout for merchant account and specific payout destinations (sellers) > - [POST /v2/accounts/{aid}/payout/payout-destinations](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_configs_post) > - [GET /v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_config_get) > - [PATCH /v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_config_patch) ## 2025-02-10 new: Update bank accounts with `owner_verified_id` field. ## 2025-02-03 new: Add endpoints for managing retained transactions > - [GET /v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}/retained-transactions](/payout-api/v2-retained-transactions/v2_aid_payout_destination_retained_get) > - [PUT /v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}/retained-transactions/{payout_event_correlation_id}/release](/payout-api/v2-retained-transactions/v2_aid_payout_destination_retained_release_put) ## 2025-01-03 new: Add description field to proposal response ## 2024-11-19 new: Add admin endpoint for unpaid debt > - [GET /v2/accounts/{aid}/payout/admin/unpaid-debt](/payout-api/v2-admin-ledger/v2_aid_admin_unpaid_debt_get) ## 2024-10-01 > change: Add new configuration option > `fund_transfers.allow_unknown_destination_payout_destination_id`, a new > configuration option to allow fund transfers to an unknown payout destination > - [PATCH /v/payout/admin/merchants/{mid}/config](/payout-api/admin-config-merchants/aid_admin_merchant_config_patch) > new: Add support for block rule based on payout destination. > > - [GET /v/accounts/{aid}/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rules_get) > - [POST /v/accounts/{aid}/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rule_post) > - [GET /v/accounts/{aid}/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_get) > - [PATCH /v/accounts/{aid}/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_patch) > - [POST /v/accounts/{aid}/payout/admin/block-rules-test](/payout-api/admin-block-rule/aid_admin_block_rule_test) ## 2024-09-01 > new: Support merchants adding buffer amounts to their payout destinations > - [POST /v1/accounts/{aid}/payout/payout_destinations](/payout-api/config-payout-destinations/aid_payout_destination_configs_post) > - [POST /v2/accounts/{aid}/payout/payout_destinations](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_configs_post) > - [PATCH /v1/accounts/{aid}/payout/payout_destinations/{pid}](/payout-api/config-payout-destinations/aid_payout_destination_config_patch) > - [PATCH /v2/accounts/{aid}/payout/payout_destinations/{pid}](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_config_patch) ## 2024-07-01 > new: Support adding a buffer amount to merchants and payout destinations > - [PATCH /v1/payout/admin/merchants/{mid}/config](/payout-api/admin-config-merchants/aid_admin_merchant_config_patch) > - [PATCH /v1/payout/admin/merchants/{mid}/payout_destinations/{pid}](/payout-api/admin-config-merchants/aid_admin_merchant_payout_destination_patch) ## 2024-03-01 > new: New v2 of api endpoints using numbers in the smallest unit for the currency for monetary amounts > - [GET /v2/accounts/{aid}/payout/payout_destinations](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_configs_get) > - [POST /v2/accounts/{aid}/payout/payout_destinations](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_configs_post) > - [GET /v2/accounts/{aid}/payout/payout_destination/{pid}](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_config_get) > - [PATCH /v2/accounts/{aid}/payout/payout_destination/{pid}](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_config_patch) > - [DELETE /v2/accounts/{aid}/payout/payout_destination/{pid}](/payout-api/v2-config-payout-destinations/v2_aid_config_payout_destination_config_delete) > - [GET /v2/accounts/{aid}/payout/payout_destinations/{pid}/transfers](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_transfers_get) > - [GET /v2/accounts/{aid}/payout/payout_destinations/{pid}/balances](/payout-api/v2-config-payout-destinations/v2_aid_payout_destination_balance_get) > - [POST /v2/accounts/{aid}/payout/fund-transfers](/payout-api/v2-fund-transfers/v2_aid_payout_fund_transfers_post) ## 2024-02-15 > new: Get a list of transfers for a payout destination configuration id > - [GET /v1/accounts/{aid}/payout/payout_destinations/{pid}/transfers](/payout-api/config-payout-destinations/aid_payout_destination_transfers_get) ## 2024-02-01 > new: Filter on payout destination configurations by payout_destination_id and get et balances per payout destination configuration id > - [GET /v1/accounts/{aid}/payout/payout_destinations](/payout-api/config-payout-destinations/aid_payout_destination_configs_get) > - [GET /v1/accounts/{aid}/payout/payout_destinations/{pid}/balances](/payout-api/config-payout-destinations/aid_payout_destination_balance_get) ## 2023-11-01 > **break**: Replace support for `write:payout:/admin/payment_approval` > scope with `write:payout:/admin/config_rfc_approval` in endpoints for > approving and rejecting a config RFC. The endpoints will now require > authorization with `admin:payout:/admin` and > `write:payout:/admin/config_rfc_approval` scope > - [POST /v/payout/admin/config-rfcs/:configRfcId/approve](/payout-api/admin-config-rfcs/aid_admin_config_rfc_approve) > - [POST /v/payout/admin/config-rfcs/:configRfcId/reject](/payout-api/admin-config-rfcs/aid_admin_config_rfc_reject) ## 2023-09-30 > new: Support updating payout destination configuration > - [PATCH /v/payout/admin/merchants/{mid}/payout_destinations/{pid}](/payout-api/admin-config-merchants/aid_admin_merchant_payout_destination_patch) ## 2023-08-01 > new: Support for syncing proposal status from items > - [POST /v/payout/admin/proposals/{proposal_id}/sync-status-from-items](/payout-api/admin-proposal/aid_admin_proposal_sync_status_from_items_post) ## 2022-10-06 > Payout destinations are now referred to as Sellers, the data model is unchanged. ## 2022-07-01 > new: Support for transfer funds between payout destinations > - [POST /v/payout/fund-transfers](/payout-api/fund-transfers/aid_payout_fund_transfers_post) > new: Support for creating `debt-transfer-correction` corrections > - [POST /v/payout/admin/ledger-corrections](/payout-api/admin-ledger/aid_ledger_corrections_post) > new: Route for admin merchant config > - [PATCH /v/payout/admin/merchants/{mid}/config](/payout-api/admin-config-merchants/aid_admin_merchant_config_patch) ## 2022-05-01 > Added properties name, description to payout destinations > Updated return type of settlement data. Now includes original transaction payout split info. ## 2021-12-01 > Sales location has been replaced with payout destination ## 2021-10-01 > new: Route for report preview > - [GET /v/payout/report-preview](/payout-api/report/aid_report_preview_get) ## 2021-09-01 > Replaced corrections with a more flexible alternative > Added route for manual matching > new: Routes for block rules > - [GET /v/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rules_get) > - [POST /v/payout/admin/block-rules](/payout-api/admin-block-rule/aid_admin_block_rule_post) > - [GET /v/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_get) > - [PATCH /v/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_patch) > - [DELETE /v/payout/admin/block-rules/{block_rule_id}](/payout-api/admin-block-rule/aid_admin_block_rule_delete) ## 2021-06-01 > new: Routes for bankfile, payment, ledger > - [GET /v1/payout/admin/bankfiles](/payout-api/admin-bankfile/aid_bankfiles_get) > - [GET /v1/payout/admin/bankfiles/{bankfile_id}](/payout-api/admin-bankfile/aid_bankfile_get) > - [GET /v1/payout/admin/bankfiles/{bankfile_id}/content](/payout-api/admin-bankfile/aid_bankfile_content_get) > - [POST /v1/payout/admin/bankfiles/{bankfile_id}/lock](/payout-api/admin-bankfile/aid_bankfile_lock_post) > - [POST /v1/payout/admin/bankfiles/{bankfile_id}/unlock](/payout-api/admin-bankfile/aid_bankfile_unlock_post) > - [GET /v1/payout/admin/payments](/payout-api/admin-bankfile/aid_payments_get) > - [GET /v1/payout/admin/payments/{payment_id}](/payout-api/admin-bankfile/aid_payment_get) > - [GET /v1/payout/admin/payment-events](/payout-api/admin-bankfile/aid_payment_events_get) > - [GET /v1/payout/admin/ledger-accounts](/payout-api/admin-ledger/aid_ledger_accounts_get) > - [GET /v1/payout/admin/ledger-correctables](#operation/aid_ledger_correctables_get) > - [POST /v1/payout/admin/ledger-corrections](/payout-api/admin-ledger/aid_ledger_corrections_post) > - [GET /v1/payout/admin/ledger-entries](/payout-api/admin-ledger/aid_ledger_entries_get) > - [GET /v1/payout/admin/ledger-entries/{entry_id}](/payout-api/admin-ledger/aid_ledger_entry_get) ## 2021-06-01 > new: Routes for settlements processed for payout > - [GET /v1/payout/admin/settlements](/payout-api/admin-settlement/aid_admin_settlements_get) > - [GET /v1/payout/admin/settlements/{settlement_id}](/payout-api/admin-settlement/aid_admin_settlement_get) > - [POST /v1/payout/admin/settlements/{settlement_id}/reject](/payout-api/admin-settlement/aid_admin_settlement_reject) > - [POST /v1/payout/admin/settlements/{settlement_id}/retry](/payout-api/admin-settlement/aid_admin_settlement_retry) ## 2021-04-07 > Initial version version: LATEST license: name: UNLICENSED url: https://dintero.com x-logo: url: https://docs.dintero.com/img/dintero-dark-padded.svg servers: - url: https://api.dintero.com security: - JWT: [] tags: - name: config-rfcs x-displayName: RFCs description: Manage RFCs - name: config-bank-accounts x-displayName: Bank accounts description: Manage bank accounts - name: config-payout-destinations x-displayName: Sellers description: Manage sellers - name: config-account-payout-destination-links x-displayName: Bank account links description: Manage link between bank account and seller - name: config x-displayName: Config description: Manage configuration - name: report x-displayName: Reports description: Manage reports - name: admin-ledger x-displayName: Ledger description: Manage ledger - name: admin-bankfile x-displayName: Bankfiles description: Manage bankfiles - name: admin-proposal x-displayName: Proposals description: Manage proposals - name: admin-settlement x-displayName: Settlements description: Manage settlements - name: admin-config x-displayName: Config description: Manage the config - name: admin-block-rule x-displayName: Block rules description: Manage block rules - name: admin-config-rfcs x-displayName: RFCs description: Admin RFCs - name: admin-config-bank-accounts x-displayName: Bank accounts description: Admin bank accounts - name: admin-config-merchants x-displayName: Merchants description: Admin merchants - name: fund-transfers x-displayName: Fund transfers description: Transfer funds between sellers - name: v2-config-rfcs x-displayName: RFCs description: Manage RFCs - name: v2-config-bank-accounts x-displayName: Bank accounts description: Manage bank accounts - name: v2-config-payout-destinations x-displayName: Sellers description: Manage sellers - name: v2-config-account-payout-destination-links x-displayName: Bank account links description: Manage link between bank account and seller - name: v2-config x-displayName: Config description: Manage configuration - name: v2-report x-displayName: Reports description: Manage reports - name: v2-admin-ledger x-displayName: Ledger description: Manage ledger - name: v2-admin-bankfile x-displayName: Bankfiles description: Manage bankfiles - name: v2-admin-proposal x-displayName: Proposals description: Manage proposals - name: v2-admin-settlement x-displayName: Settlements description: Manage settlements - name: v2-admin-config x-displayName: Config description: Manage the config - name: v2-admin-block-rule x-displayName: Block rules description: Manage block rules - name: v2-admin-config-rfcs x-displayName: RFCs description: Admin RFCs - name: v2-admin-config-bank-accounts x-displayName: Bank accounts description: Admin bank accounts - name: v2-admin-config-merchants x-displayName: Merchants description: Admin merchants - name: v2-fund-transfers x-displayName: Fund transfers description: Transfer funds between sellers - name: v2-retained-transactions x-displayName: Retained transactions description: Manage retained transactions for payout destinations paths: /v2/accounts/{aid}/payout/fund-transfers: post: tags: - v2-fund-transfers summary: v2_aid_payout_fund_transfers_post description: > You can use the endpoint to programmatically initiate a fund transfer between two sellers Requests for fund transfers are processed asynchronously so in the response, we only inform you that we received your request. You'll get the result in the settlement report operationId: v2_aid_payout_fund_transfers_post parameters: - $ref: '#/components/parameters/accountId' requestBody: content: application/json: schema: $ref: '#/components/schemas/FundTransferCreateDataV2' description: Initiate fund transfer data required: true responses: '200': description: Transfer fund initiated content: application/json: schema: type: object properties: fund_transfer: $ref: '#/components/schemas/FundTransferV2' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/AccessForbidden' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/ServerError' servers: - url: https://api.dintero.com components: parameters: accountId: name: aid description: | An id that uniquely identifies the account. in: path required: true schema: type: string format: ^[PT]{1}\d{8}$ minLength: 9 maxLength: 9 schemas: FundTransferCreateDataV2: type: object required: - fund_transfer_id - type - source_payout_destination_id - destination_payout_destination_id - amount - currency - reference properties: fund_transfer_id: type: string description: > A string id that uniquely identifies the fund transfer. The `id` is used for idempotent processing so you can safely retry the request with same id if you don't receive a response (for example, in case of a timeout) type: type: string enum: - payout-destination source_payout_destination_id: type: string destination_payout_destination_id: type: string amount: type: integer minimum: 1 description: The amount of the fund transfer in the smallest unit of the currency currency: type: string reference: type: string maxLength: 60 description: > A static reference that will be included on settlements made to the sellers FundTransferV2: description: | This object contains the result from initiating a transfer fund allOf: - $ref: '#/components/schemas/FundTransferCreateDataV2' - required: - account_id - created_at - created_by properties: account_id: type: string created_at: type: string format: date-time description: The date-time when the resource was created readOnly: true created_by: type: string description: User id of the user who created the resource readOnly: true Error: type: object required: - error properties: error: type: object required: - message properties: code: type: string description: The code used to identify the error/warning errors: type: array description: The nested error(s) encountered during validation items: type: object message: type: string description: The human readable description of the error/warning responses: BadRequest: description: Bad / Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' AccessForbidden: description: Access forbidden, invalid JWT token was used content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' ServerError: description: Unexpected Error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: JWT: type: http description: > Bearer authentication (token authentication) should be used for accessing the API. Use [Get Token](/api-reference/authenticate/aid_auths_oauth_token_post) to get an access token for client credentials. Pass the token in the request header: Authorization: Bearer {access_token} where the **access_token** is JSON Web Tokens (JWT). scheme: bearer bearerFormat: JWT ````