Payouts to Hungary

Payout parameters (EUR)

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
iban	+	string	International bank account number (without spaces)
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
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
country_iso3	+	string	Sender’s country code (ISO-3166-1 alpha-3)
code	+	string	Sender company registration number
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": {
                "iban": "NUMBER_VALUE",
                "description": "purpose of remittance"
            }
        }
    },
    "participant_details": {
        "recipient": {
           "bank_name": "All Banks Hungary / EUR / Payment System: SEPA",
           "currency": "eur",
            "country_iso3": "HUN",
            "first_name": "John",
            "last_name": "Johnson"
        },
        "sender": {
            "company_name": "Company name",
            "registration_number": "1234567890",
            "country_iso3": "USA",
            "code": "1234567890"
        }
    },
    "amount_details": {
        "amount": 1000,
        "currency": "usd"
    }
}'

Payout parameters (HUF)

Note that when making payouts in HUF, you can specify ether of the following combinations in the global parameter:

• iban
• bank_account_number, swift_bic_code

By default, the iban option is specified as required.

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
iban	+	string	International bank account number (without spaces)
bank_account_number	-	string	Bank account number for the payout
swift_bic_code	-	string	Recipient's bank’s SWIFT or BIC code
description	+	string	Purpose of remittance for the payout. This description should match the classification given in How to specify the remittance purpose
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
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
country_iso3	+	string	Sender’s country code (ISO-3166-1 alpha-3)
code	+	string	Sender company registration number
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": {
                "iban": "NUMBER_VALUE",
                "description": "purpose of remittance"
            }
        }
    },
    "participant_details": {
        "recipient": {
           "bank_name": "All Banks Hungary / HUF / Payment System: Default",
           "currency": "huf",
            "country_iso3": "HUN",
            "first_name": "John",
            "last_name": "Johnson"
        },
        "sender": {
            "company_name": "Company name",
            "registration_number": "1234567890",
            "country_iso3": "USA"
        }
    },
    "amount_details": {
        "amount": 1000,
        "currency": "usd",
        "code": "1234567890"
    }
}'

List of supported banks

Country	Currency	Bank
Hungary	EUR	All Banks Hungary / EUR / Payment System: SEPA
Hungary	HUF	All Banks Hungary / HUF / Payment System: Default