BankTransfer

How to use Bank Transfer to submit a payout in Argentina.

Submit a payout by Bank Transfer in Argentina.

POST https://sandbox.transfersmile.com/api/payout

This endpoint allows you to submit a payout by Bank Transfer in Argentina.

Headers

Name	Type	Description
Content-Type*	String	application/json; charset=UTF-8
AppId*	String	Your App ID in payout platform.
Authorization*	String	SHA256($sorted_params + $app_key)

Request Body

Name	Type	Description
account*	String	Beneficiary's Bank Account - 19 ~ 22 digits -
bank_code*	String	Bank Code in Argentina, see bank list
document_type*	String	Beneficiary's identification type. - CUIT, CUIL or DNI
document_id*	String	Beneficiary's identification number.
phone*	String	Beneficiary's phone - 0 ~ 15 digits -
name*	String	Beneficiary's name - Length must between 5 and 100 -
custom_code*	String	Merchant Payout ID - Max. 50 chars -
method*	String	Fixed value: BANKTRANSFER
account_type*	String	Beneficiary's Account Type - One of: SAVINGS, CHECKING -
amount_type	String	Specify the amount value is fixed for merchant or beneficiary - One of: source_amount, arrival_amount(default) -
amount*	String	Payout Amount, 2 decimal numbers - Min 600, Max 2,500,000 -
fee_bear*	String	Processing fee charges to merchant or beneficiary - One of: merchant, beneficiary -
country*	String	Fix value: ARG, for Argentina
additional_remark*	String	The descriptor on the user's bank bill - Max. 40 chars -
notify_url*	String	Where pagsmile will send notifications to.
arrival_currency*	String	Fixed value: ARS
source_currency*	String	Merchant Account Currency - One of: USD, EUR, GBP, ARS -
email*	String	Beneficiary's email

200: OK submit successfully

{
    "code": 200,
    "msg": "success",
    "time": 1628580845,
    "data": {
        "id": "TS202108100734054iRiUZFPXfQM",
        "custom_code": "custom_code9982674851738108",
        "arrival_amount": "0.51",
        "arrival_currency": "ARS",
        "source_amount": "0.07",
        "source_currency": "USD",
        "status": "IN_PROCESSING"
    }
}

401: Unauthorized unauthorized

{
    "code": 4004003,
    "msg": "permission denied",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

400: Bad Request order already existed

{
    "code": 4001020,
    "msg": "order already existed",
    "time": 1628580940,
    "data": {}
}

500: Internal Server Error fee not configured

{
    "code": 5001003,
    "msg": "fee not configured",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

500: Internal Server Error balance insufficient

{
    "code": 5001102,
    "msg": "balance insufficient",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

500: Internal Server Error system error

{
    "code": 5001000,
    "msg": "system error",
    "time": 1637224716,
    "data": {
        ... ...
    }
}

Example

curl --location --request POST 'https://sandbox.transfersmile.com/api/payout' \
--header 'AppId: 94FAC**********************68548' \
--header 'Authorization: d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302' \
--header 'Content-Type: application/json' \
--data-raw '{
    * "name" : "GUILHERME ****** SOUZA",
    * "phone": "12******9",
    * "email": "[e-mail]",
    * "bank_code": "015",
    * "account_type": "CHECKING", // should be one of SAVINGS, CHECKING
    * "account": "015****************475",
    * "document_id": "27*******00",
    * "document_type": "CUIT",  //
    * "source_currency": "USD", 
    * "arrival_currency": "ARS", // fixed value: ARS
    * "fee_bear": "merchant", // should be one of merchant, beneficiary
    * "method": "BANKTRANSFER", // fixed value: BANKTRANSFER
    * "amount": "1.80",
    * "notify_url": "https://notify.url",
    * "custom_code" : "custom_code9982674851738108",
    * "additional_remark": "pagsmile payout test remark",
    * "country": "ARG"  // fixed value: ARG
}
'

Note: 94FAC*********************68548 is Pagsmile's test App ID for sandbox, and d6181db0d6548b94b162e75d095b59147172d914699f83b2bd17951a671b6302 is the authorization token associated with the test App ID.

Example of Document

Document Type	Document ID	Description
CUIT	27*******00	11 digits
CUIL	27*******00	11 digits
DNI		8 digits

Example of Account

Account Type	Account	Description
CHECKING	015****************475	22 digits
SAVINGS	015****************475	22 digits

Account Validation

The first three digits of the account number are the same as the bank code. For example, if the user's bank is Industrial and Commercial Bank of China (bank code: 015), the user's account number should be 015*******************.