Payouts to USA

Payout parameters

Name	Type	Mandatory	Description
payment_method	PaymentMethod	+	Payout data
type	string	+	Value: bank_account
bank_account	BankAccount	+	Bank account
system_type	string	+	Value: global
global	BankAccountGlobal	+	Bank account details
description	string	+	Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose
bank_account_number	string	+	Bank account number for the payout
account_type	string	+	Account type. Valid values: CHECKING, SAVINGS
routing_code	string	+	ABA Routing Transfer Number
participant_details	ParticipantDetails	+	Information on the payout participants
recipient	Participant	+	Recipient details
bank_name	string	+	Important: the bank name must be chosen from the List of supported banks, otherwise the payout will fail
currency	string	+	Recipient's currency in ISO 4217 format. Case insensitive
country_iso3	string	+	Recipient's country code (ISO-3166-1 alpha-3)
first_name	string	+	Recipient's first name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
last_name	string	+	Recipient's last name. Important: if the name is passed incorrectly, the recipient bank may not accept the payout
address_line	string	+	Recipient's street address (max. 256 characters)
city	string	+	Recipient's city
postal_code	string	+	Recipient's postal code
state	string	+	Recipient's state
sender	Participant	+	Sender details
company_name	string	+	Sender company name. Limited to 100 characters, cannot contain digits only
registration_number	string	+	Sender company registration number (max. 64 characters)
country_iso3	string	+	Sender’s country code (ISO-3166-1 alpha-3)
address_line	string	+	Sender's address (max. 256 characters)
city	string	+	Sender's city
code	string	+	Sender company registration number
postal_code	string	- (mandatory for senders from Canada only)	Postal code
state	string	- (mandatory for senders from Canada only)	State
amount_details	AmountDetails	+	Payout amount details
amount	int	+	Payout amount in decimal format. The value must be greater than zero. If you are sending 100 USD, write 10000
currency	string	+	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

Country	Currency	Bank
USA	USD	All Banks United States of America