{"_id":"59dfa5868b51880010b74b0e","category":{"_id":"59dfa5828b51880010b74ac2","version":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-15T16:20:51.519Z","from_sync":false,"order":11,"slug":"resources","title":"JSON Objects"},"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"version":{"_id":"59dfa5828b51880010b74ab6","project":"57336fd5a6a9c40e00e13a0b","__v":1,"createdAt":"2017-10-12T17:25:22.850Z","releaseDate":"2017-10-12T17:25:22.850Z","categories":["59dfa5828b51880010b74ab7","59dfa5828b51880010b74ab8","59dfa5828b51880010b74ab9","59dfa5828b51880010b74aba","59dfa5828b51880010b74abb","59dfa5828b51880010b74abc","59dfa5828b51880010b74abd","59dfa5828b51880010b74abe","59dfa5828b51880010b74abf","59dfa5828b51880010b74ac0","59dfa5828b51880010b74ac1","59dfa5828b51880010b74ac2","59dfa5828b51880010b74ac3","59dfa5828b51880010b74ac4","59dfa5828b51880010b74ac5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":false,"codename":"3.23 Release","version_clean":"8976.0.0-JSON","version":"8976-JSON"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-02T17:06:54.085Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":21,"body":"[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Property\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Required\",\n    \"h-3\": \"Description\",\n    \"0-0\": \"payoutType\",\n    \"1-0\": \"baseCurrency\",\n    \"2-0\": \"nameOnAccount\",\n    \"3-0\": \"bankAccountClass\",\n    \"4-0\": \"bankAccountType\",\n    \"5-0\": \"bankName\",\n    \"6-0\": \"bankId\",\n    \"7-0\": \"country\",\n    \"9-0\": \"city\",\n    \"10-0\": \"address\",\n    \"11-0\": \"zip\",\n    \"12-0\": \"bankAccountId\",\n    \"0-1\": \"string\",\n    \"1-1\": \"string\",\n    \"2-1\": \"string\",\n    \"3-1\": \"string\",\n    \"4-1\": \"string\",\n    \"5-1\": \"string\",\n    \"6-1\": \"integer\",\n    \"12-1\": \"integer\",\n    \"7-1\": \"string\",\n    \"9-1\": \"string\",\n    \"10-1\": \"string\",\n    \"11-1\": \"string\",\n    \"0-2\": \"**Required**\",\n    \"1-2\": \"**Required**\",\n    \"2-2\": \"**Required**\",\n    \"4-2\": \"**Required**\",\n    \"5-2\": \"**Required**\",\n    \"6-2\": \"**Required**\",\n    \"7-2\": \"**Required**\",\n    \"9-2\": \"Optional\",\n    \"10-2\": \"Optional\",\n    \"11-2\": \"Optional\",\n    \"12-2\": \"**Required**\",\n    \"3-2\": \"**Required**\",\n    \"0-3\": \"Method of payout to vendor\\n\\nPossible values: \\n**ACH** (USD, CAD)\\n**CHAPS** (GBP)\\n**SEPA** (EUR)\\n**WIRE**\",\n    \"1-3\": \"Payout currency for vendor's bank account.\\n\\nPossible values: \\n**AUD** - Australia Dollar\\n**CAD** - Canada Dollar\\n**CHF** - Switzerland Franc\\n**DKK** - Denmark Kroner\\n**EUR** - Euro\\n**GBP** - United Kingdom Pound\\n**HKD** - Hong Kong Dollar\\n**JPY** - Japan Yen\\n**NOK** - Norway Kroner\\n**NZD** - New Zealand Dollar\\n**SEK** - Sweden Kroner\\n**USD** - US Dollar\",\n    \"2-3\": \"Name on bank account for vendor. Maximum 30 characters.\",\n    \"3-3\": \"Type of bank account\\n\\nPossible values: \\n**PERSONAL**\\n**CORPORATE**\\n**INTERNATIONAL**\",\n    \"4-3\": \"Account type\\n\\nPossible values: \\n**CHECKING**\\n**SAVINGS**\",\n    \"5-3\": \"Name of vendor bank. Maximum 140 characters.\",\n    \"9-3\": \"City of vendor bank. Maximum 40 characters.\",\n    \"10-3\": \"Street address of vendor bank. Maximum 60 characters.\",\n    \"11-3\": \"Zip/Postal code of vendor bank. Maximum 20 characters.\",\n    \"12-3\": \"Vendor bank account number. Maximum 34 characters.\",\n    \"6-3\": \"Bank ID number (ie. Routing number). Maximum 35 characters.\",\n    \"7-3\": \"Country code of vendor bank; See [Country codes](/v1.0/docs/country-codes)\",\n    \"8-0\": \"state\",\n    \"8-1\": \"string\",\n    \"8-2\": \"**Required** if `country` is US or CA\",\n    \"8-3\": \"State & Province code; See  [State and Province Codes](/v1.0/docs/state-and-province-codes)\",\n    \"13-0\": \"iban\",\n    \"13-1\": \"string\",\n    \"13-2\": \"**Required** if `payoutType` is CHAPS or SEPA\",\n    \"14-0\": \"swiftBic\",\n    \"14-1\": \"string\",\n    \"13-3\": \"Vendor International Bank Account Number (IBAN). 15 - 31 alphanumeric characters\",\n    \"14-2\": \"Optional\",\n    \"14-3\": \"The Bank Identifier Code of vendor bank, up to 50 alphanumeric characters\",\n    \"15-0\": \"minimalPayoutAmount\",\n    \"15-1\": \"integer\",\n    \"15-2\": \"Optional\",\n    \"15-3\": \"Minimum amount for which a vendor may be paid out. If the vendor's account balance is below this amount, their balance will be carried forward to the next pay cycle. \\n\\nInteger must be positive (i.e. 45)\\n\\nThe currency for `minimalPayoutAmount` is the same as `baseCurrency`.\",\n    \"16-0\": \"paymentReference\",\n    \"16-1\": \"string\",\n    \"16-2\": \"Optional\",\n    \"16-3\": \"Reference text that will appear on your vendor's bank statement when they are paid out. If left blank, the text will be the standard message (i.e. \\\"BlueSnap Payment for Merchant {Merchant ID}\\\"). \\n\\nMaximum 100 alphanumeric characters.\\n\\n**Note**: Not applicable if `payoutType` is **ACH** and `baseCurrency` is **CAD**.\"\n  },\n  \"cols\": 4,\n  \"rows\": 17\n}\n[/block]","excerpt":"","slug":"payoutinfo","type":"basic","title":"payoutInfo"}
Property
Type
Required
Description

payoutType

string

Required

Method of payout to vendor

Possible values:
ACH (USD, CAD)
CHAPS (GBP)
SEPA (EUR)
WIRE

baseCurrency

string

Required

Payout currency for vendor's bank account.

Possible values:
AUD - Australia Dollar
CAD - Canada Dollar
CHF - Switzerland Franc
DKK - Denmark Kroner
EUR - Euro
GBP - United Kingdom Pound
HKD - Hong Kong Dollar
JPY - Japan Yen
NOK - Norway Kroner
NZD - New Zealand Dollar
SEK - Sweden Kroner
USD - US Dollar

nameOnAccount

string

Required

Name on bank account for vendor. Maximum 30 characters.

bankAccountClass

string

Required

Type of bank account

Possible values:
PERSONAL
CORPORATE
INTERNATIONAL

bankAccountType

string

Required

Account type

Possible values:
CHECKING
SAVINGS

bankName

string

Required

Name of vendor bank. Maximum 140 characters.

bankId

integer

Required

Bank ID number (ie. Routing number). Maximum 35 characters.

country

string

Required

Country code of vendor bank; See Country codes

state

string

Required if country is US or CA

State & Province code; See State and Province Codes

city

string

Optional

City of vendor bank. Maximum 40 characters.

address

string

Optional

Street address of vendor bank. Maximum 60 characters.

zip

string

Optional

Zip/Postal code of vendor bank. Maximum 20 characters.

bankAccountId

integer

Required

Vendor bank account number. Maximum 34 characters.

iban

string

Required if payoutType is CHAPS or SEPA

Vendor International Bank Account Number (IBAN). 15 - 31 alphanumeric characters

swiftBic

string

Optional

The Bank Identifier Code of vendor bank, up to 50 alphanumeric characters

minimalPayoutAmount

integer

Optional

Minimum amount for which a vendor may be paid out. If the vendor's account balance is below this amount, their balance will be carried forward to the next pay cycle.

Integer must be positive (i.e. 45)

The currency for minimalPayoutAmount is the same as baseCurrency.

paymentReference

string

Optional

Reference text that will appear on your vendor's bank statement when they are paid out. If left blank, the text will be the standard message (i.e. "BlueSnap Payment for Merchant {Merchant ID}").

Maximum 100 alphanumeric characters.

Note: Not applicable if payoutType is ACH and baseCurrency is CAD.