Ask us anything. We're here to help.

Withdrawal API Response Field Interpretation

General

Platform's can use the GET /withdrawals/requests and GET /withdrawals/requests/:id endpoint to consume important information related to fiat or crypto withdrawals. See below use cases to see what fits your Zero Hash integration:

Use Cases

Has the balance been deducted from the Zero Hash ledger?

Use the status field. Options:

  • PENDING: The request has been created and is pending approval from users. Not relevant for some use cases. If configured for 0 withdrawal approvals required, the withdrawal instantly goes into an APPROVED state.
  • APPROVED: The request is approved but not settled
  • REJECTED: The request is rejected and in a terminal state
  • SETTLED: The funds have been deducted from the participant

Has the withdrawal has been confirmed on-chain (crypto)

Use the on_chain_status field. Options:

  • PENDING: The withdrawal has been broadcasted on-chain but is not yet confirmed
  • CONFIRMED: The withdrawal has been sufficiently confirmed on-chain according to our confirmation thresholds, which can be viewed here in Confirms column here.

What is the on-chain transaction hash?

Use the transaction_id field.