Payouts to USA

Payout parameters

Name	Mandatory	Type	Description
payment_method	+	object	Payout data
type	+	string	Value: bank_account
bank_account	+	object	Bank account
system_type	+	string	Value: global
global	+	object	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	+	object	Information on the payout participants
recipient	+	object	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	+	object	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	- (mandatory for senders from Canada only)	string	Postal code
state	- (mandatory for senders from Canada only)	string	State
amount_details	+	object	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