Create a Global Account

Open a global account for receiving funds in your chosen currency. The account supports local clearing and cross-border wire transfer payments in multiple currencies and regions. Check supported regions and currencies for details.
Request Parameters
requestIdstring
required
Idempotency key. A unique request identifier. Use a unique value (e.g., UUID) for each operation.
bankRegionstring
required
Region where the bank is located, following the ISO 3166 standard. See Data Types (e.g., "US", "GB", "HK").
requiredFeaturesarray
required
Receiving capabilities to request for this account. Each entry specifies one currency and payment method combination. Maximum 10 elements.
Show child parametersShow child parameters
nickNamestring
User-defined account label for internal reference. Not displayed on bank statements. Defaults to the merchant name if not provided.
Response Parameters
resultResult
See Result.
idstring
Unique account identifier. Use this ID for subsequent query, update, and close operations. Returned when the account creation request is accepted.
accountNamestring
Legal name of the account holder as registered with the bank.
nickNamestring
User-defined account label for internal reference. Not displayed on bank statements. Defaults to the merchant name if not provided.
accountTypestring
Account type at the bank. Currently only CHECKING is supported.
statusstring
Account lifecycle status (e.g., ACTIVE, PROCESSING). See GlobalAccountStatus.
failureReasonstring
Reason for account creation failure. Inspect this field to determine whether retrying with different parameters is possible. Returned when status is FAILED.
accountNumberstring
Bank account number for receiving local payments. Share this with payers as the destination account. Returned when status is ACTIVE.
ibanstring
International Bank Account Number (IBAN) for receiving payments in supported regions (e.g., EU countries). Returned when applicable.
swiftCodestring
SWIFT/BIC code for receiving cross-border wire transfers. Returned for most bankRegion values where SWIFT is available (e.g., US, GB, HK).
institutionInstitution
Bank where the account is held. Returned when status is ACTIVE.
Show child parametersShow child parameters
requiredFeaturesarray
Echo of the receiving capabilities requested at account creation.
Show child parametersShow child parameters
supportedFeaturesarray
Actual receiving capabilities provisioned for the account. Differs from requiredFeatures when the bank provides additional capabilities. Returned when status is ACTIVE.
Show child parametersShow child parameters
createdAtdatetime
Timestamp when the account was created, following the ISO 8601 standard. See Data Types.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccess.N/A
ACCOUNT_STATUS_INVALIDFYour account status does not support this operation.Check the account `status` — only ACTIVE or PROCESSING accounts can be modified. Verify the account is not CLOSED or FAILED.
REGION_NOT_SUPPORTEDFThis region is not supported.Check `bankRegion` is a supported ISO 3166 two-letter code.
ACCOUNT_VERIFICATION_REQUIREDFPlease complete account verification.Complete account verification before opening a global account.
ACCOUNT_AUTHORIZATION_REQUIREDFYour account is not authorized for this operation.Contact support to grant access/authorization.
Definition
POST /api/open/v1/globalAccounts/create
Request
{
"requestId": "f18d0117-095a-4782-a8f1-eeb16c3be3b4",
"bankRegion": "US",
"nickName": "USD in US for Subsidiary Company ABC",
"requiredFeatures": [
  {
    "currency": "USD",
    "paymentType": "LOCAL"
  },
  {
    "currency": "USD",
    "paymentType": "CROSS"
  }
]
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "2026032519121000470000009473",
"accountName": "Sandbox Business",
"nickName": "USD in US for Subsidiary Company ABC",
"accountType": "CHECKING",
"status": "ACTIVE",
"accountNumber": "8484346726",
"iban": "GB82XXXX0000012345678900",
"swiftCode": "CMFGUS33",
"institution": {
  "bankAddress": "",
  "branchCode": "",
  "bankName": "Example Bank Ltd",
  "bankRegion": "US"
},
"requiredFeatures": [
  {
    "currency": "USD",
    "paymentType": "LOCAL"
  },
  {
    "currency": "USD",
    "paymentType": "CROSS"
  }
],
"supportedFeatures": [
  {
    "type": "RECEIVING",
    "currency": "USD",
    "paymentNetwork": "ACH",
    "routingCodes": [
      {
        "type": "ACH",
        "value": "026073150"
      }
    ],
    "paymentType": "LOCAL"
  },
  {
    "type": "RECEIVING",
    "currency": "USD",
    "paymentNetwork": "SWIFT",
    "routingCodes": [
      {
        "type": "SWIFT",
        "value": "CMFGUS33"
      }
    ],
    "paymentType": "CROSS"
  }
],
"createdAt": "2026-03-30T12:08:56+08:00"
}