Bank Account
POST
/bank_account_intentsCreate Bank Account Intent
CreateBankAccountIntentDTO — mints a hosted create-bank-account link for an account (account: your own or a connected account). Auto-added to mirror the backend route. Body/params are placeholders derived from the handler DTO.
Request
Example
curl -X POST 'https://api.paycose.com/api/v1/app1/platform/wallet/bank_account_intents/' \
-H 'X-Session-Token: {{session_token}}' \
-H 'X-Country: {{country}}' \
-H 'X-Test-Mode: {{x_test_mode}}' \
-d '{
"account": "{{account_id}}",
"return_url": "https://example.com/return",
"refresh_url": "https://example.com/refresh",
"metadata": {}
}'Headers
| Name | Value | Description |
|---|---|---|
| X-Session-Token | {{session_token}} | |
| X-Country | {{country}} | |
| X-Test-Mode | {{x_test_mode}} | true=wallet_test, false=wallet_live (default). Toggle the x_test_mode collection variable to flip every applicable request. |
Body
| Name | Type | Value |
|---|---|---|
| account | string | {{account_id}} |
| return_url | string | https://example.com/return |
| refresh_url | string | https://example.com/refresh |
| metadata | object | {…} |
{
"account": "{{account_id}}",
"return_url": "https://example.com/return",
"refresh_url": "https://example.com/refresh",
"metadata": {}
}Responses
200200 OK
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Body
{
"session": "<string>",
"link": "<string>"
}400400 Bad Request
Headers
| Name | Value |
|---|---|
| Content-Type | application/json |
Body
{
"object": "error",
"code": "<string>",
"key": "<string>",
"i18n_key": "<string>",
"message": "<string>",
"request_id": "<string>"
}