Langsung ke konten utama
POST
curl

Parameter Path

token
string
wajib

Token sesi yang tidak transparan yang dikembalikan saat sesi widget dibuat.

Body

application/json
method
enum<string>
wajib

Metode bukti yang dipilih pengguna akhir. Harus berupa salah satu dari allowed_methods milik konteks.

Opsi yang tersedia:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

Default-nya adalah wallet_address sesi. Harus cocok dengan dompet transfer saat sesi ditautkan ke suatu transfer.

Maximum string length: 128
chain
string

Default-nya adalah blockchain sesi.

Maximum string length: 32

Respons

Bukti yang sudah terbuka untuk metode ini, dilanjutkan.

proof_id
string<uuid>
method
enum<string>
Opsi yang tersedia:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: pengguna akhir memilih metode ini dan bukti belum diputuskan. Tanda tangan yang gagal atau deposit uji yang belum dapat dibaca atau belum dikonfirmasi membuat bukti tetap PENDING dengan failure_reason, sehingga pengguna akhir dapat mencoba lagi; deposit SATOSHI_TEST yang dikirimkan diperiksa ulang secara otomatis hingga jendelanya ditutup, dan SCREENSHOT yang dikirimkan menunggu peninjauan Anda. VERIFIED: kepemilikan terbukti. REJECTED: deposit uji benar-benar salah (pengirim lain, bukan jumlah yang diharapkan ke alamat deposit, lebih lama dari tantangan, atau transaksi yang sudah membuktikan dompet lain) atau peninjau Anda menolak tangkapan layar; failure_reason menyatakan alasannya. Bukti yang ditolak bersifat final dan menggunakan salah satu upaya sesi. EXPIRED: bukti tidak dapat lagi diputuskan (jendelanya ditutup, pengguna akhir berganti metode, sesi widget berakhir, atau pemegang dompet berubah); failure_reason menyatakan alasannya.

Opsi yang tersedia:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

Pengenal blockchain kanonis untuk entri buku alamat tempat bukti tersebut ditujukan, misalnya ETH, BTC, SOL, TRX.

deposit_address
string | null

Alamat deposit yang harus dikirimi jumlah Satoshi untuk pengujian oleh pelanggan. Hanya ada pada bukti SATOSHI_TEST.

expected_amount
string | null

Jumlah on-chain persis, dalam mata uang asli deposit, yang harus cocok dengan deposit uji coba Satoshi. Hanya ada pada bukti SATOSHI_TEST.

expires_at
string<date-time> | null

Batas waktu untuk jendela Satoshi test milik bukti ini. Hanya ada pada bukti SATOSHI_TEST; expires_at milik sesi widget diperpanjang untuk mencakupnya saat SATOSHI_TEST ditawarkan.

challenge
string | null

Pesan yang diterbitkan Didit yang ditandatangani pelanggan dengan dompet mereka. Hanya ada pada bukti MESSAGE_SIGNING.

rejection_reason
string

Alasan mengapa bukti ditolak, sebagai kalimat bahasa Inggris untuk pengguna akhir. Hanya ada jika status adalah REJECTED; kosong saat peninjau Anda menolak tangkapan layar (catatan Anda tetap tersimpan untuk Anda).

created_at
string<date-time>
attempts
integer

Berapa kali bukti diserahkan untuk bukti ini (tanda tangan, id transaksi, unggahan).

failure_reason
enum<string>

Alasan mengapa upaya terakhir gagal, atau mengapa bukti ditutup. Kosong jika tidak ada yang gagal.

Opsi yang tersedia:
,
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
Terakhir diubah pada 7 November 2026