Supported Bank List Query

Required for Some Cash and Banktransfer methods

This API is only used for Brazil (OpenFinance), Colombia (PSE), Chile (Khipu), Argentina, Bolivia, Panama, Paraguay and Uruguay

The bank-list result could be different for the Test environment and the Prod environment. It is recommended to check the bank-list before each transaction.

Request Base URL

  Test Environment : https://gateway-test.pagsmile.com
  Prod Environment : https://gateway.pagsmile.com

EndPoints

  /trade/bank-list

Request Header

ParameterRequiredDescription

Content-Type

recommend

application/json

Authorization

yes

Basic Base64(app_id:security_key)

Request Body (JSON format)

ParameterTypeRequiredMax Length(or Default Value)Description

app_id

string

yes

32

created app's id at dashboard

timestamp

string

yes

19

yyyy-MM-dd HH:mm:ss

method

string

yes

32

Request Sample

curl --location --request POST 'https://gateway.pagsmile.com/trade/bank-list' \
--header 'Authorization: Basic Base64(appid:secret_key)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "app_id",
    "timestamp": "{{datetime}}",
    "method": "{{method}}"
}'

Http Response (JSON format)

ParameterTypeDescription

code

string

return code

msg

string

return message

data.bank_id

string

bank id: used for parameter "bank"

data.bank_name

string

bank name

min_amount

string

min amount for this bank. Only for Khipu

data.detail

string

Return Code (Success)

{
    "code": "10000",
    "msg": "Success",
    "data"."bank_id": "{{bank_id}}",
    "data"."bank_name": "{{bank_name}}",
    "min_amount": "200",
    "data"."detail": ""
}

Return Code (Fail)

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}

Last updated