Traducción Automática

Esta página utiliza traducción automática. Para cualquier inconsistencia, consulte la documentación en inglés.

Callbacks

Crypto2B proporciona la capacidad de generar notificaciones para el sistema del cliente con información sobre operaciones (por ejemplo, depósitos, retiros, operaciones de servicio). Los callbacks se utilizan para este propósito.

Configuración

Si el cliente desea utilizar el mecanismo de callback para rastrear el estado de procesamiento de las operaciones, es necesario configurar la URL de callback en la cuenta personal.

Luego, durante el procesamiento de pagos cripto, Crypto2B enviará notificaciones en formato JSON a esta URL con toda la información necesaria sobre la transacción.

Contenido del Callback

Los callbacks de Crypto2B contienen toda la información importante sobre la transacción:

• tipo de operación
• estado de procesamiento
• moneda
• dirección
• monto
• hash de transacción blockchain
• número de confirmaciones
• comisión

y más

Ejemplos de Callbacks

Depósito

{
  "data": {
    "type": "Deposit",
    "id": 123456,
    "status": "Success",
    "date": "2024-01-15T10:30:00Z",
    "clientDepositId": "client-deposit-001",
    "error": null,
    "instrument": {
      "currencyShortName": "USDT",
      "transportProtocol": "trc20"
    },
    "address": {
      "address": "TExampleDepositAddress1234567890abc",
      "tag": null,
      "foreignId": "user-12345",
      "senderAddress": "TExampleSenderAddress0987654321xyz"
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "abc123def456abc123def456abc123def456abc123def456abc123def456abcd",
      "amount": 1000.50,
      "confirmations": 21,
      "amlRiskGrade": "Low"
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "USDT",
        "transportProtocol": "trc20",
        "amount": 5.00
      }
    ]
  }
}

Retiro

{
  "data": {
    "type": "Withdrawal",
    "id": 789012,
    "status": "Success",
    "date": "2024-01-15T14:45:00Z",
    "paymentOrderId": "withdrawal-order-001",
    "foreignId": "user-withdrawal-789",
    "error": null,
    "instrument": {
      "currencyShortName": "BTC",
      "transportProtocol": "btc"
    },
    "address": {
      "address": "bc1qexamplewithdrawaladdress000000000000000",
      "tag": null
    },
    "transaction": {
      "approach": "FullProcessing",
      "hash": "00000000000000000000abcdef1234567890abcdef1234567890abcdef123456",
      "amount": 0.05,
      "confirmations": 6,
      "amlRiskGrade": null
    },
    "fees": [
      {
        "type": "Commercial",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.0001
      },
      {
        "type": "Technical",
        "currencyShortName": "BTC",
        "transportProtocol": "btc",
        "amount": 0.00005
      }
    ]
  }
}

Operación de Servicio

{
  "data": {
    "type": "Service",
    "id": 345678,
    "soType": "Collection",
    "status": "Success",
    "date": "2024-01-15T16:00:00Z",
    "error": null,
    "instrument": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20"
    },
    "sender": "0x0000000000000000000000000000000000000001",
    "recipient": "0x0000000000000000000000000000000000000002",
    "transaction": {
      "hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "amount": 2.5,
      "confirmations": 35
    },
    "technicalFee": {
      "currencyShortName": "ETH",
      "transportProtocol": "erc20",
      "amount": 0.002
    }
  }
}

Descripciones de Campos

Campo	Descripción
type	Tipo de operación: Deposit, Withdrawal, Service
id	Identificador único de operación en el sistema
status	Estado de procesamiento de la operación
date	Fecha y hora de la operación (ISO 8601)
instrument	Información de moneda y protocolo
address	Dirección de transacción y parámetros adicionales
transaction	Detalles de transacción blockchain
fees	Array de comisiones (comerciales, técnicas)
error	Mensaje de error (si existe)

Campos específicos de depósito

Campo	Descripción
clientDepositId	ID de depósito en el sistema del cliente
address.foreignId	Identificador externo de usuario
address.senderAddress	Dirección del remitente

Campos específicos de retiro

Campo	Descripción
paymentOrderId	ID de orden de pago
foreignId	Identificador externo de operación

Campos específicos de operación de servicio

Campo	Descripción
soType	Tipo de operación de servicio (ej., Collection)
sender	Dirección del remitente
recipient	Dirección del destinatario
technicalFee	Comisión técnica de la operación

Nota Importante

Deduplicación

Tenga en cuenta que debido a especificaciones de implementación, el mismo callback puede enviarse varias veces en ocasiones. Siempre rastree los identificadores de transacción para evitar doble gasto y problemas similares.