Transfersmile PTTransfersmile PT
  • EN
  • PT
  • ES
  • EN
  • PT
  • ES
  • Introdução
  • API Payin
    • Ambientes
    • Integração direta
      • Brasil
        • Cartão de crédito
        • Pix
        • Lotérica
        • Boleto
        • Depósito Express
        • Carteira
    • Notificação
      • Segurança
    • Detalhes Payin
    • Reembolso
    • Plug-in & Ferramentas
      • transfersmile JavaScript
      • transfersmile SDK
      • Lista de Bancos Suportados
      • Consulta de detalhes de parcelamento
    • Dados
      • Método de Pagamento
      • Dados para teste (Sandbox)
      • Status Payin
      • Lista de Bancos
      • Ícone dos métodos
    • Código API
  • API Payout
    • Ambientes
    • Segurança
    • Criar um payout
      • Carteira transfersmile
        • Exemplo WebView
        • Autorização H5
        • Autorização de App nativo
        • Enviar prêmios
      • Brasil
        • Pix
        • Transferência bancária
    • Notificação
    • Payout DryRun
    • Saldo da Conta
    • Status do Payout
    • Lista de Payout
    • Detalhes do Payout
    • Método de pagamento
    • Dados para teste
    • Código do Banco
      • Bancos Brasil
    • Código API

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âmetroObrigatórioDescrição
Content-Typerecommendapplication/json
AuthorizationsimBasic Base64(app_id:security_key)

Corpo da solicitação (formato JSON)

ParâmetroTipoObrigatórioComprimento máximo(ou valor padrão)Descrição
app_idstringsim32app's id criado no dashboard
timestampstringsim19yyyy-MM-dd HH:mm:ss
out_trade_nostringsim64Nº da transação do comerciante (não pode estar vazio com trade_no ao mesmo tempo)
trade_nostringsim64Nº 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âmetroTipoDescrição
codestringreturn code
msgstringreturn msg
out_trade_nostringmerchant's trade NO.
trade_nostringtransfersmile's trade NO.
trade_statusstringstatus
order_amountdecimalamount
order_currencystringmoeda
create_timestringyyyy-MM-dd HH:mm:ss[UTC]
update_timestringyyyy-MM-dd HH:mm:ss[UTC]
refuse_detailstringRefuse only
customer.identify.typestring​
customer.identify.numberstring​
customer.emailstring​
customer.phonestring​

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"
}
Prev
Notificação
Next
Reembolso