Ayuda
Gate Pay
Guía de integración de comerciantes

Gate Pay FAQ

2025-06-25 UTC
17869 Leído
3

Preguntas Frecuentes

Límites de Cantidad de Orden

1. Límite de Monto Mínimo: Gate financiación: 0.0001 (todas las unidades de moneda)

Pago On-Chain de Web3: 0.01 USDT (o equivalente en otras monedas)

Cantidad Mínima de Intercambio Rápido: La API de consulta de pares de divisas devolverá los valores máximos y mínimos.

La cantidad del orden no debe ser inferior a la cantidad mínima establecida. Por ejemplo, si el límite de cantidad mínima es 0.0001, el monto de la orden debe ser ≥ 0.0001, como 0.0001, 0.00011, etc.

2. Límite de Precisión: El número de decimales en la cantidad del orden no debe exceder la precisión establecida. Por ejemplo, si la precisión está establecida en 0.0001 (es decir, hasta 4 lugares decimales), 0.001 es válido, pero 0.00011 resultará en un error y no será redondeado.

El monto de la orden debe conocer ambos los requisitos de cantidad mínima y precisión, de lo contrario, no se puede enviar. Por ejemplo, si el la cantidad mínima es 0.0001 y el el límite de precisión es 0.1, 0.01 no cumpliría con el requisito de precisión y resultaría en un error.

Explicación de la tarifa de retiro

API para Verificar el Estado de Retiro

https://www.gate.com/docs/developers/apiv4/es/#recuperar-el-estado-de-retiro

Descripción

El "Comprobar el estado de retiro" API permite a los usuarios recuperar información sobre las tarifas de retiro para diferentes tokens en las cadenas soportadas. Los usuarios pueden seleccionar la cadena según sea necesario.

Parámetros de tarifa

retirar_fijo_en_cadenas: Tarifa de retiro fija

retirar_porcentaje_en_cadenas: tarifa de retiro basada en porcentaje (aplicable a ciertos tokens especiales, calculada como Monto de Retiro × Tasa de Porcentaje)

Fórmula de cálculo

Tarifa de Retiro = Tarifa Fija + ( Tasa de comisión porcentual × Monto de retiro)

Notas Adicionales

Las cadenas más comúnmente utilizadas solo cobran un comisión de retiro fija, que actualizaciones cada hora.

Por favor Haga una solicitud de API antes de cada retiro obtener los últimos datos de tarifas y asegurar cálculos precisos.

¿Por qué un pago realizado dentro del período de validez se marca como una orden expirada?

El tiempo de pago se determina en función de cuándo se detecta la transacción en cadena, no cuándo el usuario inició el pago. Puede ocurrir un retraso entre estos dos momentos.

¿Por qué las facturas mostradas en la app o web de Gate difieren del pago real recibido?

La aplicación o la web muestra la cantidad de la orden, no la cantidad real pagada por el usuario. Incluso si el pago del usuario difiere de la cantidad de la orden, la cantidad de la orden seguirá mostrándose. Para la facturación detallada, siempre consulte el backend del comerciante.

Significado de merchantTradeNo y merchantUserId en la API de Crear Orden

  1. merchantTradeNo: El número de orden en el sistema del comerciante, con una longitud máxima de 32 caracteres.
  2. merchantUserId: La ID de cuenta de usuario en el sistema del comerciante. Esta debe ser una ID de usuario válida; de lo contrario, los reembolsos relacionados con el pago a la DIRECCIÓN fallarán ya que el sistema no puede identificar al usuario.

Información de Callback para Pagos en la DIRECCIÓN On-chain

¿Por qué hay dos notificaciones de callback para los pagos?

  1. Notificación de llegada de fondos (TRANSFER_ADDRESS): Una notificación sobre la financiación recibida.
  2. Notificación de cambio de estado de orden (DIRECCIÓN_PAGO): Una notificación sobre cambios en el estado de la orden.

Los comerciantes necesitan confiar en estos dos tipos de información para determinar si la orden fue exitosa para proceder con el envío o manejar órdenes fallidas.

¿Cuándo se envían las notificaciones de devolución de llamada?

  1. Notificación de llegada de fondos Enviado después de que el pago se confirme on-chain, permitiendo que los fondos se acrediten a la cuenta del comerciante en tiempo real mientras se notifica al comerciante.
  2. Notificación de cambio de estado de orden Se activa cuando el estado de la orden cambia.

Entendiendo el Estado del Callback

1. Notificación de llegada de fondos (biztype = TRANSFER_ADDRESS)

  • DIRECCIÓN_TRANSFERIDA_EN_TÉRMINO: Los fondos se acreditan en tiempo real dentro del período de validez de la orden.
  • DIRECCIÓN_TRANSFERIDA_CON_RETRASO: Los fondos recibidos después del período de validez se acreditan en la cuenta de pago del comerciante (crédito en tiempo real posterior al período de validez).
  • DIRECCIÓN_TRANSFERIDA_BLOQUEADA: La transacción tiene un riesgo de seguridad potencial y es rechazada. Por favor, contacta a Gate Pay para obtener asistencia en el reembolso del pago.

2. Notificación de Cambio de Estado de Orden (biztype = DIRECCIÓN_PAGO)

  • PAY_SUCCESS: El pago fue exitoso.
  • PAY_CLOSE: La orden ha expirado.
  • PAY_EXPIRED_IN_PROCESS: Esperando la confirmación on-chain de los fondos.

Escenarios de Pago y Determinación del Estado de la Orden para Pagos de DIRECCIÓN on-chain

1. Pago completo o exceso de pago dentro del período de validez

Descripción : Si un usuario paga el monto total o más del monto requerido dentro del período de validez, una vez confirmado en on-chain, se activan ambos callbacks.

Notificación del estado del orden :

  • Inicialmente: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Después de la confirmación: bizStatus = PAY_SUCCESS, doneAmountOnChain incluido.

Notificación de llegada de fondos : bizStatus = TRANSFERIDO_DIRECCIÓN_EN_TÉRMINO, cantidad acreditada = transferAmount.

2. Pago Parcial dentro del Período de Validez

Descripción : El usuario paga menos que el monto de la orden dentro del período de validez. Una vez confirmado on-chain, el monto se acredita y se envía una notificación de llegada de fondos.

Notificación de Estado de Orden : No activado.

Notificación de llegada de financiación : bizStatus = DIRECCIÓN_TRANSFERIDA_EN_TÉRMINO, amount = transferAmount.

3. Pago parcial sin suplemento

Descripción : Se realiza un pago parcial, pero no se agrega ninguna cantidad adicional antes de la expiración.

Notificación de estado de orden : Enviado al expirar la orden: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.

Notificación de llegada de fondos : Ya se envió anteriormente cuando llegaron los fondos. No repetir callback.

4. Pago parcial con suplemento

4.1 Suplementado dentro del período de validez Notificación de estado de orden :

  • Tras la suplementación: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Después de la confirmación: bizStatus = PAY_SUCCESS, doneAmountOnChain refleja el total recibido.

Notificación de llegada de fondos : Enviado solo después de la confirmación: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, amount = transferAmount.

4.2 Suplementado Después del Período de Validez

Notificación de Estado de la Orden :

  • Al expirar: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
  • No hay notificación adicional del estado de la orden después de la suplementación tardía.

Notificación de llegada de fondos :

  • Tras la suplementación tardía: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount.
  • doneAmountOnChain no será incluido. Los comerciantes necesitan agregar manualmente múltiples valores de transferAmount.

5. Pago realizado después de la expiración

Descripción : El usuario paga después de que la orden haya expirado, independientemente de la cantidad.

Notificación de Estado de Orden : Al expirar: bizStatus = PAY_CLOSE.

Notificación de llegada de fondos :Al realizar un pago tardío: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount. No doneAmountOnChain y sin callback de estado de orden para pagos posteriores a la expiración. Los comerciantes deben sumar todos los valores de transferAmount recibidos..

El comerciante debe determinar el éxito de una orden en función del estado de la orden y las notificaciones de devolución de llamada de llegada de fondos.

¡Regístrese ahora para tener la oportunidad de ganar hasta $10,000!
signup-tips