Skip to main content

Payouts to USA

Payout parameters

NameTypeMandatoryDescription
payment_methodPaymentMethod+Payout data
 typestring+Value: bank_account
 bank_accountBankAccountPaymentMethod+Bank account
  system_typestring+Value: global
  globalBankAccountGlobal+Bank account details
   descriptionstring+Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose
   bank_account_numberstring+Bank account number for the payout
   account_typestring+Account type. Valid values: CHECKING, SAVINGS
   routing_codestring+ABA Routing Transfer Number
participant_detailsParticipantDetails+Information on the payout participants
 recipientParticipant+Recipient details
  bank_namestring+Important: the bank name must be chosen from the List of supported banks, otherwise the payout will fail
  currencystring+Recipient's currency in ISO 4217 format. Case insensitive
  country_iso3string+Recipient's country code (ISO-3166-1 alpha-3)
  first_namestring+Recipient's first name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
  last_namestring+Recipient's last name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
  address_linestring+Recipient's street address (max. 256 characters)
  citystring+Recipient's city
  postal_codestring+Recipient's postal code
  statestring+Recipient's state
 senderParticipant+Sender details
  company_namestring+Sender company name. Limited to 100 characters, cannot contain digits only
  registration_numberstring+Sender company registration number (max. 64 characters)
  country_iso3string+Sender’s country code (ISO-3166-1 alpha-3)
  address_linestring+Sender's address (max. 256 characters)
  citystring+Sender's city
  codestring+Sender company registration number
  postal_codestring- (mandatory for senders from Canada only)Postal code
  statestring- (mandatory for senders from Canada only)State
amount_detailsAmountDetails+Payout amount details
 amountint+Payout amount in decimal format. The value must be greater than zero. If you are sending 100 USD, write 10000
 currencystring+ISO 4217 currency code. Case insensitive

Example

curl -X POST \
https://demo.smart-glocal.com/api/v1/session/start/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d'{
"session_id": "ps_1053680",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "global",
"global": {
"bank_account_number": "bank account number",
"routing_code": "routing transfer number",
"account_type": "CHECKING",
"description": "purpose of remittance"
}
}
},
"participant_details": {
"recipient": {
"address_line": "Recipient's address",
"bank_name": "All Banks United States of America",
"city": "City name",
"currency": "USD",
"country_iso3": "USA",
"first_name": "John",
"last_name": "Johnson",
"postal_code": "postal code",
"state": "state"
}
},
"sender": {
"company_name": "Company name",
"registration_number": "1234567890",
"country_iso3": "USA",
"city": "City name",
"address_line": "Sender's address",
"code": "1234567890"
},
"amount_details": {
"amount": 1000,
"currency": "usd"
}
}

List of supported banks

CountryCurrencyBank
USAUSDAll Banks United States of America