Transfersmile ESTransfersmile ES
  • EN
  • PT
  • ES
  • EN
  • PT
  • ES
  • Introducción
  • API Payin
    • Ambientes
    • Integración Directa
      • Brasil
        • Tarjeta de Crédito
        • Pix
        • Lottery
        • Boleto
        • Depósito Express
        • Wallet
    • Notificaciones
      • Security
    • Detalle de Pago
    • Reembolso
    • Plug-in & Herramientas
      • transfersmile JavaScript
      • transfersmile SDK
      • Registro de lista de Bancos Disponibles
      • Verificación de Detalle de Cuotas
    • Data
      • Método de Pago
      • Data para pruebas (Sandbox)
      • Estado de Payin
      • Lista de Bancos
      • Logos de los métodos
    • Código API
  • Payout API
    • Ambientes
    • Seguridad
    • Enviar un payout
      • transfersmile Wallet
        • Ejemplo WebView
        • Authorización H5
        • Autorización Nativa de APP
        • Enviar Bonificaciones
      • Brasil
        • Pix
        • Transferencia Bancaria
    • Notificaciones
    • Simulación de Payout
    • Balance de cuenta
    • Status de Payout
    • Lista de Payout
    • Detalle de Payout
    • Métodos de Pago
    • Data para pruebas
    • Códigos de Banco
      • Bancos en Brasil
    • Código API

Integración Directa

API Pago Directo

Solicitud Base URL

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

EndPoints

/trade/pay

Request Header

ParametroRequeridoDescripción
Tipo-Contenidorecomendadoapplication/json
AutorizaciónsiBásica Base64(app_id:security_key)

Request Body (JSON format)

ParametroTipoRequeridoMax longitud(o valor defecto)Descripción
app_idstringSi32App Id creada en dashboard
timestampstringSi19yyyy-MM-dd HH:mm:ss
out_trade_nostringSi64ID dada por el merchant en su sistema
methodstringno32Payment Methods​
channelstringno32sub canal (sólo usar en método 'Wallet')
order_currencystringSi3BRL for brasil
order_amountdecimalSi0.01 ~ 99999999999999.99Monto solicitado de pago
subjectstringSi128Razón de pago o título de item
contentstringSi255Detalle de razón de pago o detalle de item. Se mostrará en la factura bancaria.
notify_urlstringSiIPN URL al merchant(empieza con http)
buyer_idstringSimerchant id de usuario
timeout_expressstringno90mm(minutos), h(horas), d(días), c(siempre termina en día actual)
tokenstringno​requerido para tarjeta de crédito
fingerprintstringno​requerido para tarjeta de crédito
issuerstringnoEmisor de tarjeta de crédito(requerido para tarjeta de crédito)
installmentsintegerno1Cuotas para tarjeta de crédito
bankstringno​Código de banco, requerido para DepositExpress (itau,santander,bradesco,banco-do-brasil,caixa) Efectivo (Usar bank_id desde Bank Query); Transferenciabancaria (Use bank_id desde Bank Query); Khipu (Use bank_id desde Bank Query);
language_codestringno​Código de idioma, requerido para Efectivo, Transferenciabancaria . (Use language_code desde Bank query)
customer.namestringSi​Nombre de usuario
customer.emailstringSi​Correo de usuario
customer.phonestringSi​Teléfono celular del usuario
customer.identify.numberstringSi​Número ID del usuario
customer.identify.typestringSi​Tipo de ID del usuario
address.zip_codestringSizip code
address.statestringSi​Estado
address.citystringSi​Ciudad
address.street_numberstringSi​street1 number
address.streetstringSi​street1
address.neighborhoodstringno​street2
user_ipstringno​Dirección IP de usuario(requerido por Tarjeta de crédito)
website_urlstringno128URL de website del merchant

Ejemplo de solicitud

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"
}'

Http Response (formato JSON )

ParametroTipoDescripción
codestringcódigo retornado
​ msgstringretornado msg
​ sub_codestringretornado sub code(sólo error)
​ sub_msgstringretornado sub msg(sólo error)
out_trade_nostringrequest out_trade_no
​ trade_nostringtransfersmile NO. de transacción
​ trade_statusstring
​ pay_urlstringpay URL; sólo en Boleto、Lottery、DepositExpress

​ barcode | string | Boleto barcode;o en Boleto | ​ qr_code | string | Sólo en PIX |

​ provider_owner | string | banco info : dueño de cuenta; sólo en DepositExpress​ | ​ provider_owner_document | string | banco info : documento de dueño de cuenta; sólo en DepositExpress​ | ​ provider_agency | string | banco info : agencia de banco; sólo en DepositExpress​ | ​ provider_number | string | banco info : número de cuenta; sólo en DepositExpress​ |

​ bank_name | string | banco info : nombre de banco; sólo en DepositExpress |

​ wallet_url | string | Sólo en Wallet | ​ app_link_url | string | Sólo en Wallet (para uso de APP) | ​ instruction | string | Take the recipient's bank details from the response parameter - "instruction" and present to users | Bolivia, Paraguay, Uruguay: Bank Transfer | ​

Return Code (Exitoso)

{
    "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}"
}

Return Code (Fallido)

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

Atención

Return_url no es necesario en los parámetros de solicitud, también puede anexar el return_url después de la web_url cuando se redirige: http://checkout.transfersmile.com?prepay_id={$prepay_id} ↓↓↓ http://checkout.transfersmile.com?prepay_id={$prepay_id}&return_url={$return_url}