# Payin Detail

# URL base de solicitação

Ambiente de teste : https://gateway-test.transfersmile.com

Ambiente de Prod : https://gateway.transfersmile.com

# EndPoints

/trade/query

# Cabeçalho de solicitação

Parâmetro Obrigatório Descrição
Content-Type recommend application/json
Authorization sim Basic Base64(app_id:security_key)

# Corpo da solicitação (formato JSON)

Parâmetro Tipo Obrigatório Comprimento máximo(ou valor padrão) Descrição
app_id string sim 32 app's id criado no dashboard
timestamp string sim 19 yyyy-MM-dd HH:mm:ss
out_trade_no string sim 64 Nº da transação do comerciante (não pode estar vazio com trade_no ao mesmo tempo)
trade_no string sim 64 Nº da transação da transfersmile (não pode estar vazio com trade_no ao mesmo tempo)

# Exemplo de Solicitação

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

# Resposta Http (formato JSON)

Parâmetro Tipo Descrição
code string return code
msg string return msg
out_trade_no string merchant's trade NO.
trade_no string transfersmile's trade NO.
trade_status string status
order_amount decimal amount
order_currency string moeda
create_time string yyyy-MM-dd HH:mm:ss[UTC]
update_time string yyyy-MM-dd HH:mm:ss[UTC]
refuse_detail string Refuse only
customer.identify.type string
customer.identify.number string
customer.email string
customer.phone string

# Retorno (Sucesso)

{
  "code": "10000",
  "msg": "Success",
  "trade_no": "",
  "out_trade_no": "",
  "trade_status": "",
  "order_currency": "",
  "order_amount": "",
  "customer": {
      "identify": {
          "number": "",
          "type": ""
      },
      "email": "",
      "phone": ""
  },
  "refuse_detail": "",
  "create_time": "",
  "update_time": ""
}

# Retorno (Falhou)

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