--- title: "Create a fiat withdrawal account" method: POST path: "/v3/withdrawals/fiat/accounts" tags: ["Fiat withdrawal account"] --- # Create a fiat withdrawal account `POST /v3/withdrawals/fiat/accounts` ## Request - Base URL: `https://confirmo.net/api` - URL: `https://confirmo.net/api/v3/withdrawals/fiat/accounts` - Auth: HTTP bearer Creates a new fiat withdrawal account for approval. Provide exactly one account variant: `iban`, `bic`+`accountNumber`, or `routingNumber`+`accountNumber` (US domestic wire). Which variants are available, and whether `bankName` is mandatory, depends on the merchant's banking configuration. The address fields describe the account owner (beneficiary), not their bank. ## Request body - CreateFiatWithdrawalAccountRequest: Request to create a fiat withdrawal account. Provide exactly one account variant: 'iban', 'accountNumber'+'bic', or 'accountNumber'+'routingNumber'. - `account` FiatWithdrawalAccountDetailsRequest, required: Bank account details. Provide exactly one variant: 'iban', 'bic'+'accountNumber', or 'routingNumber'+'accountNumber'. Some banking configurations additionally require 'bankName'. The address fields below describe the account owner (beneficiary) — the bank's own address is not collected. - `accountNumber` string: Account number. Requires bic (BIC variant) or routingNumber (ABA variant). - `address` string, required: Street address of the account owner (beneficiary), not of their bank. No diacritics: the banks carry no alphabet beyond letters, digits, spaces and / ? : ( ) . , ' + -, and an unsupported character is refused here rather than at the bank. Depending on the merchant's banking configuration a stricter limit of 35 characters may apply. - `bankName` string: Beneficiary bank name. Required for ABA accounts, and may be required for BIC accounts depending on the merchant's banking configuration. The bank's address is not collected — it is derived from the account identifier. - `bic` string: BIC/SWIFT code. Required with accountNumber for the BIC variant. - `city` string, required: City of the account owner (beneficiary). No diacritics - see 'address'. Depending on the merchant's banking configuration a stricter limit of 35 characters may apply. - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', required: ISO 3166-1 alpha-2 country code of the account owner (beneficiary). - `iban` string: IBAN. - `intermediaryAddress` string: Street address of the correspondent institution. Required wherever the correspondent itself is required. Depending on the merchant's banking configuration a stricter limit may apply: 35 characters, and only letters, digits, spaces and / ? : ( ) . , & ' + - - `intermediaryBankName` string: Name of the correspondent institution. Required whenever a correspondent is provided. - `intermediaryBic` string: BIC/SWIFT code of the beneficiary bank's correspondent institution, which settles the wire's currency leg. Provide this or 'intermediaryRoutingNumber', not both. Only valid for the BIC variant. Not accepted by every banking configuration: some require the correspondent to be identified by 'intermediaryRoutingNumber' instead. - `intermediaryCity` string: City of the correspondent institution. Required wherever the correspondent itself is required. Depending on the merchant's banking configuration a stricter limit may apply: 35 characters, and only letters, digits, spaces and / ? : ( ) . , & ' + - - `intermediaryCountry` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AN' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': ISO 3166-1 alpha-2 country code of the correspondent institution. Required whenever a correspondent is provided. - `intermediaryRoutingNumber` string: ABA routing number of the beneficiary bank's correspondent institution, for a US-based correspondent. Provide this or 'intermediaryBic', not both. Depending on the merchant's banking configuration this may be the only accepted way to identify a correspondent — some require the ABA even where the correspondent also publishes a BIC. - `postalCode` string, required: Postal code of the account owner (beneficiary). No diacritics - see 'address'. - `routingNumber` string: ABA routing number (US domestic wire). Required with accountNumber for the ABA variant. - `accountHolderName` string, required: Name of the account owner (beneficiary). No diacritics - the banks carry only letters, digits, spaces and / ? : ( ) . , ' + -, and an unsupported character is refused here rather than at the bank. Depending on the merchant's banking configuration a stricter limit of 35 characters may apply. - `accountName` string, required: Name of the fiat withdrawal account. ## Response `201` Fiat withdrawal account created successfully. - CreateFiatWithdrawalAccountResponse - `account` union: Bank account details. - AbaAccountResponse - `accountNumber` string: Bank account number. - `address` string: Street address of the account owner (beneficiary). - `bankName` string: Beneficiary bank name. - `city` string: City of the account owner (beneficiary). - `country` string: ISO 3166-1 alpha-2 country code of the account owner (beneficiary). - `postalCode` string: Postal code of the account owner (beneficiary). - `routingNumber` string: ABA routing number (US domestic wire). - BicAccountResponse - `accountNumber` string: Bank account number. - `address` string: Street address of the account owner (beneficiary). - `bankName` string: Beneficiary bank name, if provided. - `bic` string: BIC/SWIFT code. - `city` string: City of the account owner (beneficiary). - `country` string: ISO 3166-1 alpha-2 country code of the account owner (beneficiary). - `intermediaryAddress` string: Street address of the correspondent institution, if one is recorded. - `intermediaryBankName` string: Name of the correspondent institution, if one is recorded. - `intermediaryBic` string: BIC of the beneficiary bank's correspondent institution, if one is recorded. - `intermediaryCity` string: City of the correspondent institution, if one is recorded. - `intermediaryCountry` string: ISO 3166-1 alpha-2 country code of the correspondent institution, if one is recorded. - `intermediaryRoutingNumber` string: ABA routing number of the correspondent institution, if one is recorded. - `postalCode` string: Postal code of the account owner (beneficiary). - IbanAccountResponse - `address` string: Street address of the account owner (beneficiary). - `city` string: City of the account owner (beneficiary). - `country` string: ISO 3166-1 alpha-2 country code of the account owner (beneficiary). - `iban` string: IBAN. - `postalCode` string: Postal code of the account owner (beneficiary). - `accountHolderName` string: Name of the account owner (beneficiary). - `accountId` string: Fiat withdrawal account ID. - `accountName` string: Name of the fiat withdrawal account. ## Other responses - `400`: Validation failed. - `403`: Forbidden - `409`: Conflict --- [API](https://skmtc.dev/confirmo/apis/confirmo-api.md) - [All operations](https://skmtc.dev/confirmo/apis/confirmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confirmo/apis/confirmo-api/revisions/09bef7db3dd1?raw)