Integración API
Pasarela de pago en criptomonedas Bitnovo Pay
Diseñada para ser utilizada de dos maneras diferentes:
Redirect Gateway: Solo disponible para pagos en línea. El usuario es redirigido a la pasarela de pago Bitnovo Pay, donde se le ayuda a realizar el pago cripto. Dependiendo de la configuración del comerciante, se retorna al página web del comercio cuando la transacción es detectada o confirmada.
API Gateway: Disponible para pagos en línea y fuera de línea. El comerciante/proveedor de pagos recibe la información del pago de Bitnovo Pay y se muestra al usuario final.
Redirect Gateway
También hay dos opciones para usar la pasarela en este modo:
Indicando el símbolo de la criptomoneda
El proceso comienza cuando el comerciante llama al endpoint de currencies_list. Para asegurarse que la moneda que desea mostrar esté disponible en este momento. Una vez confirmado, el comercio llama al endpoint de orders_create. Enviando el importe en divisa fiat, el símbolo de la criptomoneda, las URLs OK y KO y una descripción opcional para el pago. Luego, Bitnovo Pay responde con la URL de redirección y el comerciante traslada al usuario a la URL de redirección. Una vez que el usuario es redirigido, intentará realizar el pago en la pasarela Bitnovo Pay. Cuando el usuario finaliza el proceso de pago, es redirigido a la URL OK (URL de pagos exitoso) o a la URL KO (URL de pagos fallido) dependiendo del resultado.
Sin indicar el símbolo de la criptomoneda
El proceso comienza cuando el comerciante llama al endpoint de orders_create. Enviando el monto en fiat, las URLs OK y KO y una descripción opcional para el pago. Luego, Bitnovo Pay responde con la URL de redirección y el comerciante traslada al usuario a la URL de redirección. Una vez que el usuario es redirigido, intentará realizar el pago en la pasarela Bitnovo Pay. Cuando el usuario finaliza el proceso de pago, es redirigido a la URL OK (URL de pagos exitosos) o a la URL KO (URL de pagos fallidos) dependiendo del resultado.
En ambos casos, el comerciante será notificado de los cambios de estado a través de notify_merchant webhook.
API Gateway
El proceso comienza cuando el comercio llama al endpoint orders_create. Enviando el monto en fiat, el símbolo de la criptomoneda (opcional) y una descripción si es necesario. Luego, Bitnovo responde con la información de pago.
La información de pago debe ser mostrada al usuario por el comerciante, durante el proceso de pago Bitnovo informará al comerciante sobre las actualizaciones del estado del proceso a través de notify_merchant webhook.
Estado de Pago Importante
"AC"
"Awaiting Completion" + 'safe'= True
Para este estado de pago, debes verificar el parámetro 'safe'. Si 'safe' = true, la cantidad de criptomoneda ha sido detectada en el mempool y se confirmará rápidamente. Esto ocurre solo con criptomonedas con tecnología UTXO como Bitcoin, si la tarifa de transacción es óptima y RBF (Replace by fee) no está activado. El comercio puede tomar este estado como "Completado" para un flujo más rápido.
"CO"
"Completed"
La cantidad de criptomoneda tiene al menos 1 confirmación en la cadena de bloques.
"OC"
"Out of Condition"
La cantidad de criptomoneda es insuficiente, por lo que el pago está incompleto. En este caso, el comerciante puede solicitar el resto del pago a través de Bitnovo Pay (u otro método) o realizar un reembolso. El comerciante debe revisar el parámetro 'received_amount' para conocer la cantidad restante.
“RF”
“Refunded”
Una vez que el pago está "Completed" o "Out of Condition", puede ser reembolsado a través de la API o el Panel de Control.
Otros estados de pago
"NR"
"Not Ready"
El pago aún no ha recibido un símbolo de criptomoneda. (Solo para Redirect Gateway).
"PE"
"Pending"
El pago está esperando recibir la cantidad de criptomoneda.
"AC"
"Awaiting Completion" + 'safe'= False
Para este estado de pago, debes verificar el parámetro 'safe'. Si 'safe' = false, la cantidad de criptomoneda ha sido detectada en el mempool y debe esperar a ser confirmada. Esto sucede solo con criptomonedas UTXO como Bitcoin si la tarifa de transacción es inferior al mercado y/o RBF (Replace by fee) está activado. El comerciante/cliente debe esperar a que el pago se cambie a "Completed" después de la confirmación.
"IA"
"Insufficient Amount"
La cantidad de criptomoneda es menor a la requerida. El cliente aún tiene tiempo para pagar el resto y satisfacer la cantidad requerida.
"CA"
"Cancelled"
El pago expiró después de más de 24 horas o el cliente lo canceló.
"EX"
"Expired"
El pago no recibió ninguna criptomoneda durante el tiempo de vencimiento (15/60 minutos).
"FA"
"Failed"
El pago ha fallado porque la transacción no se confirmó.
Flujo de pago
Como comerciante, puedes implementar el siguiente flujo de pago:
NR (Not Ready) / PE (Pending) / AC (Awaiting Completion) + safe=False
Pending
CO (Completed) / AC (Awaiting Completion) + safe=True
Processing
CA (Cancelled) / EX (Expired)
Cancelled
FA (Failed) / OC (Out of Condition)
Failed
RF (Refunded)
Refunded
Última actualización