# Installment Detail Query

# Request Base URL

Test Environment : https://gateway-test.transfersmile.com

Prod Environment : https://gateway.transfersmile.com

# EndPoints

/trade/installments

# Request Header

Parameter Required Description
Content-Type recommend application/json
Authorization yes Basic
Base64(app_id:security_key)

# Request Body (JSON format)

Parameter Type Required Max 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
amount decimal yes 0.01 ~ 99999999999999.99 amount
currency string yes 3 currency

# Request Sample

curl --location --request POST 'https://gateway.transfersmile.com/trade/installments' \
--header 'Authorization: Basic Base64(appid:security_key)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "app_id",
    "timestamp": "{{datetime}}",
    "amount": "{{amount}}",
    "currency": "{{currency}}"
}'

# Http Response (JSON format)

Parameter Required Description
code string return code
msg string return msg
fee List Fee​ fee detail list

# Fee

Parameter Required Description
stage string stage of installments
amount_each string amount for each stage
amount Fee total amount

# Return Code (Success)

{
  "code": "10000",
  "msg": "Success",
  "fee": [
    {
      "stage":1,
      "amount_each":200.00,
      "amount":200.00
    },
    ...
  ]
}

# Return Code (Fail)

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