Create Funding Account

POST

/api/v1/transformer/accounts/{entityId}/create/funding_account/{jurisdictionId}

Creates a new virtual account in a chosen jurisdiction with unique banking details for fiat currency transactions. Note that creating a funding account incurs a fee, and only one funding account per jurisdiction is allowed.

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Path Params

Responses

🟢200Success

application/json

Successfully created or found existing funding account

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/transformer/accounts/entity_c2f742c5_ea24_405f_a329_c73c0b3234a2/create/funding_account/jurisdiction_8eeecfd0_2944_46f4_b7f3_ae4cd7b41f41'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "message": "Funding account already exists",
        "data": {
            "id": "fa_94c0dd27_d828_4788_9e1a_572c478af013",
            "entityId": "entity_c2f742c5_ea24_405f_a329_c73c0b3234a2",
            "jurisdictionId": "jurisdiction_8eeecfd0_2944_46f4_b7f3_ae4cd7b41f41",
            "providerId": "infrap_b01b7d4f_a274_4b30_833a_cca39fe9e76c",
            "status": "active",
            "accountInfo": {
                "currency": "usd",
                "bank_name": "Bank of Nowhere",
                "bank_address": "1800 North Pole St., Orlando, FL 32801",
                "bank_routing_number": "101019644",
                "bank_account_number": "900573609824",
                "bank_beneficiary_name": "John Doe",
                "bank_beneficiary_address": "123 Main St, Apt 1, Anytown, CA 12345, US",
                "payment_rail": "ach_push",
                "payment_rails": [
                    "ach_push",
                    "wire"
                ]
            }
        }
    }
}

Modified at 2025-11-11 17:25:09

Get External Accounts

Activate Funding Account