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

Integração direta

API de Pagamento direto

URL base de solicitação

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

EndPoints

/trade/pay

Cabeçalho de solicitação

ParâmetroObrigatórioDescrição
Content-Typerecomendadoapplication/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 Id criado no dashboard
timestampstringsim19yyyy-MM-dd HH:mm:ss
out_trade_nostringsim64ID dada pelo comerciante em seu sistema
methodstringnão32Métodos de Pagamento​
channelstringnão32sub-canal (usar somente no método 'Carteira')
order_currencystringsim3BRL para Brasil
order_amountdecimalsim0.01 ~ 99999999999999.99valor da solicitação de pagamento
subjectstringsim128motivo do pagamento ou nome do item
contentstringsim255Detalhe do motivo de pagamento ou detalhe do item. Isto será mostrado na conta bancária..
notify_urlstringsimURL IPN para comerciante(comece com http)
buyer_idstringsimID do usuário do comerciante
timeout_expressstringnão90mm(minutos), h(horas), d(dias), c(termina no dia atual)
tokenstringnão​​necessário para cartão de crédito​
fingerprintstringnão​​necessário para cartão de crédito​
issuerstringnãoemissor de cartões de crédito(necessário para cartão de crédito)
installmentsintegernão1parcelas para cartão de crédito
bankstringnão​código bancário, necessário para Depósito Expresso (itau,santander,bradesco,banco-do-brasil,caixa) Dinheiro (Use bank_id da Lista de Bancos);Transferência bancária(Use bank_id da Lista de Bancos); Khipu (Use bank_id da Lista de Bancos);
language_codestringnão​language code, necessário for Dinheiro, Transferência bancária. (Use language_code da Lista de Bancos Suportados)
customer.namestringsim​nome do usuário
customer.emailstringsim​email do usuário
customer.phonestringsim​telefone do usuário
customer.identify.numberstringsim​ID do usuário
customer.identify.typestringsim​tipo de do usuário
address.zip_codestringsimCEP
address.statestringsim​estado
address.citystringsim​cidade
address.street_numberstringsim​street1 number
address.streetstringsim​street1
address.neighborhoodstringnão​street2
user_ipstringnão​endereço IP do usuário(necessário para cartão de crédito)
website_urlstringnão128URL do site do comerciante

Exemplo de Solicitação

curl --location --request POST 'https://gateway.transfersmile.com/trade/create' \
--header 'Authorization: Basic Base64(appid:security_key)' \
--header 'Content-Type: application/json' \
--data-raw '{
    "app_id": "app_id",
    "content": "content",
    "method": "Boleto",
    "notify_url": "notify_url",
    "order_amount": 10,
    "order_currency": "BRL",
    "out_trade_no": "{{$randomUUID}}",
    "subject": "subject",
    "timeout_express": "1h",
    "timestamp": "{{datetime}}",
    "customer": {
      "name": "name",
      "email": "email",
   "phone": "phone",
   "identify": {
  "number":"number",
  "type":"type“,
   }
      ...
    },
    "address": {
      "zip_code": "84043450",
      "state": "Parana",
      "city": "Ponta Grossa",
      "street"; "Colônia Dona Luíza",
      "street_number": "18",
    },
    "user_ip": "127.0.0.1"
}'

Resposta Http (formato JSON)

ParâmetroTipoDescrição
codestringreturn code
​ msgstringreturn msg
​ sub_codestringreturn sub code(only error)
​ sub_msgstringreturn sub msg(only error)
out_trade_nostringrequest out_trade_no
​ trade_nostringtransfersmile trade NO.
​ trade_statusstring
​ pay_urlstringpay URL; somente em Boleto、Lotérica、Deposito Expresso
​ barcodestringcódigo de barras do Boleto;somente em Boleto
​ qr_codestringsomente em PIX
​ provider_ownerstringinformações bancárias: proprietário da conta; somente em Deposito Express
​ provider_owner_documentstringinformações bancárias: documento do proprietário da conta; somente em Deposito Expresso
​ provider_agencystringinformações bancárias : agência da conta; somente em Deposito Expresso
​ provider_numberstringinformações bancárias : número da conta; somente em Deposito Expresso
​ bank_namestringinformações bancárias : nome do banco; somente em Deposito Expresso
​ wallet_urlstringsomente na carteira
​ app_link_urlstringsomente na carteira (para uso em APP)

Retorno (Sucesso)

{
    "code": "10000",
    "msg": "Success",
    "out_trade_no": "{out_trade_no}",
    "trade_no": "{trade_no}",
    "trade_status": "PROCESSING",
    "pay_url": "https://checkout-testv2.transfersmile.com/checkout?prepay_id=XX",
    "barcode": "{barcode}",
    "qr_code": "{qr_code}",
    "provider_owner": "{provider_owner}",
    "provider_owner_document": "{provider_owner_document}",
    "provider_agency": "{provider_agency}",
    "provider_number": "{provider_number}",
    "wallet_url": "{wallet_url}",
    "app_link_url": "{app_link_url}"
}

Retorno (Falhou)

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

Atenção

Return_url não é necessário nos parâmetros de solicitação, você também pode anexar o return_url após o web_url ao redirecionar: http://checkout.transfersmile.com?prepay_id={$prepay_id} ↓↓↓ http://checkout.transfersmile.com?prepay_id={$prepay_id}&return_url={$return_url}

Prev
Ambientes
Next
Notificação