Our API
Aceptar pagos en un sitio web o en una tienda en línea es una de las cosas más importantes. Debe ser conveniente para su usuario pagar por bienes o servicios de una manera conveniente, rápida o habitual.
Nuestro sitio proporciona todos los métodos de pago necesarios.
Una única forma de pago permite pagar una factura tanto en bitcoins (BTC) como en USDT desde una billetera externa, desde una aplicación de teléfono inteligente utilizando un código QR, desde la billetera de un usuario en el sitio desde una tarjeta bancaria de casi cualquier banco del mundo o mediante la compra de criptomonedas en más de 400 puntos de intercambio con pago por todos los sistemas de pago posibles, incluido PayPal, con abono automático a su cuenta mercantil.
Y también el usuario puede comprar bitcoins con más de 40 métodos de pago en la plataforma P2P, como: Yandex Money, WebMoney, QIWI, ADVCASH, Alipay, ePayments, M-PESA, PAYEER, PayPal, Paysend, SKRILL, UnionPay, WeChat, Western Union, etc.
Luego pague la factura desde una cuenta de operaciones de cifrado, con este tipo de pago no se cobra comisión al usuario.
La aceptación de pagos desde nuestra plataforma es la opción más flexible, rentable y más completa, en cuanto a métodos de pago, para aceptar pagos en Internet.
Team, CryptoKick.app
Our service
API para BTC automatizado: aceptación de Bitcoin y pago directo desde tarjetas bancarias
Crear pago
Para iniciar un pago usando una sola forma de pago, solo necesita dirigir al usuario a una URL especial.
| Parámetro | Valor | Descripción | |
|---|---|---|---|
| act | request_payment | Obligatorio | Parámetro del sistema. No cambia |
| test | Y o N | Obligatorio | Crear un pago en modo de prueba |
| form | Y o N | Obligatorio | Mostrar formulario de pago o mostrar resultado JSON |
| coin | BTC USDT |
Obligatorio |
Only for form = Y / N Only for form = N |
| id | Número | Obligatorio | Identificador de la configuración del comerciante de pagos |
| amount | Número | Obligatorio | Importe del pago en la moneda de la cuenta |
| currency | USD / EUR / CNY / RUB / GBP / BRL / UAH / KZT / BTC / USDT | Obligatorio | Moneda de la cuenta según ISO 4217 |
| external_invoice | Cadena | Obligatorio | Número de cuenta externa utilizada en su tienda |
| message | Cadena | Obligatorio | Descripción de la cuenta |
| signature | Cadena | Obligatorio | Firma digital |
| callback_url | Cadena | Parámetro opcional | URL para llamar al recibir el pago de la factura |
You can specify the Callback URL in the merchant settings in the panel
- La firma digital se forma como sha256 (los parámetros para inicializar el pago descritos anteriormente con secretKey = TECLA DE ACCESO desde la configuración del comerciante de pagos). Al crear la firma digital, todas las variables enumeradas en el ejemplo deben indicarse.
Un ejemplo de generación de una firma digital en PHP
- https://cryptokick.app/api/merchant.php?
- act=request_payment
- test=Y
- form=Y
- coin=BTC
- id=Identificador de la configuración del comerciante de pagos
- amount=0.01
- currency=BTC
- external_invoice=1000
- message=Test Invoice
- signature=Firma digital
- callback_url=http://example.com/pay.php
Ejemplo de inicialización de pago
Modo de prueba
Si el valor del parámetro es test = Y, la solicitud se ejecuta en modo de prueba. La factura tendrá el estado Pagado sin pago real y acreditando el pago. No se enviará una notificación de pago por correo electrónico. Si la URL del controlador se transmite ( parámetro callback_url), se le enviará el resultado
Mostrar el resultado
Si el valor del parámetro es form = N, el resultado del pago generado se muestra en formato JSON para su posterior procesamiento
Success
| Parámetro | Valor | Descripción |
|---|---|---|
| status | Cadena | Return success |
| amount | Número | Importe del pago en la criptomoneda seleccionada |
| invoice | Número | Número de cuenta interno utilizado en el sistema |
| external_invoice | Cadena | Número de cuenta externo utilizado en su tienda |
| link | Cadena | Link to QR code |
| address | Cadena | Dirección de billetera generada (BTC / USDT) |
| message | Cadena | Descripción de la cuenta que se transmitió cuando se generó la cuenta |
Error
| Parámetro | Valor | Descripción |
|---|---|---|
| status | Cadena | Return error |
| message | Cadena | Error message |
Procesador de pagos
Al recibir el pago de la factura, notificamos al sitio web de la tienda el estado del pago enviando una solicitud GET a la URL del controlador (parámetro callback_url).
| Parámetro | Descripción |
|---|---|
| id | Identificador de la configuración del comerciante de pagos |
| key | Clave de confirmación de la configuración del comerciante de pagos |
| coin | ¿Qué criptomoneda pagó la factura |
| currency | En qué moneda se genera la cuenta de acuerdo con ISO 4217 |
| invoice | Número de cuenta interno utilizado en el sistema |
| external_invoice | Número de cuenta externo utilizado en su tienda |
| amount | Cantidad del pago recibido en criptomoneda |
| amount_in_currency | Monto de la cuenta en la moneda de la cuenta generada |
| message | Descripción de la cuenta que se transmitió cuando se generó la cuenta |
| signature | Firma digital generada |
- En el procesador de pagos, debe generar una firma digital utilizando las variables recibidas y compararla con la firma digital recibida. Para el valor secretKey, use la TECLA DE ACCESO de la configuración del comerciante de pagos.
Un ejemplo de la formación y verificación de una firma digital en PHP
- En el procesador de pagos, debe verificar la CLAVE DE CONFIRMACIÓN recibida con la CLAVE DE CONFIRMACIÓN desde la configuración del comerciante de pagos.
- Compruebe siempre el cumplimiento de todos los parámetros recibidos, así como las direcciones IP desde las que se envían las solicitudes al procesador de pagos
Formato de respuesta de notificación de pago
Es aplicable si la URL del controlador se especifica durante la formación del pago (parámetro callback_url)
Como resultado del procesamiento de una solicitud GET que contiene datos de pago, el sitio web de la tienda debe devolver una respuesta con el código 200 como una cadena:
- La respuesta es igual a la línea 'ok'- esto significa que se han recibido los datos de pago, ya no se requieren notificaciones para este pago.
- Cualquier otra respuesta: esto significará que la tienda no ha recibido los datos y la tienda continuará siendo notificada
Nota: número máximo de notificaciones para recibir una respuesta exitosa del sitio web de la tienda:
Nota: cada nueva notificación se intentará cada 5 minutos
Si la respuesta no es igual a la cadena 'ok', los primeros 255 caracteres de la respuesta de la tienda a la solicitud se guardarán y estarán disponibles para su visualización en su cuenta.
Nota: si la solicitud se ejecuta en modo de prueba y la notificación de pago falló, el código de respuesta y la línea de respuesta estarán disponibles en la página de pago de la factura. Para ver, haga clic en el estado de notificación del destinatario. En el modo normal, se muestra solo estado
Banners recomendados para la colocación
50x160 px