Add external banking account number - Payee

API Method: POST /api/fundsMovement/v2/connectNonVerifiedExternalBankAccount

Description:

This endpoint allows the authenticated user to add a new external bank account as a payee for funds movement, even if the account is not yet verified. The added external bank account can be used for transfers and payments after the user completes the verification process. This functionality is useful when linking accounts from external financial institutions for future transactions.

Request:

  • HTTP Method: POST
  • Endpoint: /api/fundsMovement/v2/connectNonVerifiedExternalBankAccount
  • Authentication: Requires authentication (e.g., Bearer token or session ID) to ensure that only authorized users can add external bank accounts.

Request Body:

  • Content-Type: application/json

Response:

  • Status Code: 200 Created — On success, the API confirms that the external bank account has been added as a payee, though it still requires verification before it can be used for transactions.
  • Content-Type: application/json

Possible Errors:

  • 400 Bad Request: The request contains invalid data or missing required fields.
  • 401 Unauthorized: The request was made without proper authentication or with an invalid token.
  • 403 Forbidden: The user does not have permission to add external bank accounts.
  • 409 Conflict: The external bank account already exists or has been previously added.
  • 500 Internal Server Error: An error occurred on the server while processing the request.

This request adds an external bank account to the user's account as a payee, with the account being unverified initially. The user must complete the verification process before this account can be used for transfers or other financial activities.

Language
Credentials
Bearer
JWT
Click Try It! to start a request and see the response here!