Saltar al contenido principal
POST
curl

Parámetros de ruta

token
string
requerido

Token de sesión opaco devuelto cuando se generó la sesión del widget.

Cuerpo

application/json
method
enum<string>
requerido

El método de prueba que eligió el usuario final. Debe ser uno de los allowed_methods del contexto.

Opciones disponibles:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Por defecto, el wallet_address de la sesión. Debe coincidir con la wallet de la transferencia cuando la sesión está vinculada a una transferencia.

Maximum string length: 128
chain
string

Por defecto, la blockchain de la sesión.

Maximum string length: 32

Respuesta

La prueba ya abierta para este método, reanudada.

proof_id
string<uuid>
method
enum<string>
Opciones disponibles:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: el usuario final eligió este método y la prueba aún no se ha decidido. Una firma fallida o un depósito de prueba que todavía no se puede leer o no está confirmado mantiene la prueba en PENDING con un failure_reason, para que el usuario final pueda volver a intentarlo; un depósito SATOSHI_TEST enviado se vuelve a comprobar automáticamente hasta que se cierra su ventana, y una SCREENSHOT enviada queda a la espera de tu revisión. VERIFIED: la propiedad está demostrada. REJECTED: el depósito de prueba es realmente incorrecto (otro remitente, un importe distinto del esperado a la dirección de depósito, anterior al desafío o una transacción que ya demostró otra wallet) o tu revisor rechazó la captura de pantalla; failure_reason indica el motivo. Una prueba rechazada es definitiva y consume uno de los intentos de la sesión. EXPIRED: la prueba ya no se puede decidir (su ventana se cerró, el usuario final cambió de método, la sesión del widget caducó o cambió el titular de la wallet); failure_reason indica el motivo.

Opciones disponibles:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Identificador canónico de la cadena de la entrada de la libreta de direcciones a la que corresponde la prueba, p. ej., ETH, BTC, SOL, TRX.

deposit_address
string | null

Dirección de depósito a la que el cliente debe enviar el importe de la prueba Satoshi. Solo está presente en una prueba SATOSHI_TEST.

expected_amount
string | null

Importe on-chain exacto, en la moneda nativa del depósito, con el que debe coincidir el depósito de prueba de Satoshi. Solo está presente en una prueba SATOSHI_TEST.

expires_at
string<date-time> | null

Fecha límite de la ventana de prueba Satoshi propia de esta prueba. Solo está presente en una prueba SATOSHI_TEST; el expires_at propio de la sesión del widget se amplía para cubrirla cuando se ofrece SATOSHI_TEST.

challenge
string | null

Mensaje emitido por Didit que el cliente firma con su wallet. Solo está presente en una prueba MESSAGE_SIGNING.

rejection_reason
string

Por qué se rechazó la prueba, como una frase en inglés para el usuario final. Solo está presente cuando status es REJECTED; vacío cuando tu revisor rechazó una captura de pantalla (tu nota se queda contigo).

created_at
string<date-time>
attempts
integer

Cuántas veces se envió evidencia para esta prueba (firmas, ids de transacción, archivos subidos).

failure_reason
enum<string>

Por qué el último intento no fue suficiente, o por qué se cerró la prueba. Vacío cuando nada falló.

Opciones disponibles:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED
Última modificación el 1 de noviembre de 2026