Skip to content
Withdrawals

Get Withdrawal Details

Queries one withdrawal by withdrawal request id, including the amount, fee, status, order number, creation and update times, payee and receiving bank information, payee address, remarks, the history of receiving card changes, whether the receiving card can be changed, and any card change awaiting confirmation. Used on the withdrawal result and details pages.

Next steps: when state is 0 or 15, cancel with POST /v2/portfolio/withdraw/cancel using order_id. When can_edit_card is true, change the receiving card with PUT /v1/portfolio/withdraw/member/change/card. When to_be_changed_card is returned, call POST /v1/portfolio/withdraw/card/change/process after the Client confirms, to accept the card change. Some tenant channels use GET /v7/portfolio/withdraw/detail/no/trade/auth, a version that returns the same data without trading password verification and takes the same parameter, but does not return card_id, payee_address, or to_be_changed_card.card_id.

When calling through WhaleCore requestService(), set requiresTradeToken to true.

GEThttps://api.lbkrs.com/v7/portfolio/withdraw/detail

Parameters

idstringqueryRequired

Withdrawal request id, from id returned by the withdrawal submission or list[].id of the withdrawal records

Responses

HTTP 200The request succeeded. The response body contains the result of the “Get Withdrawal Details” operation.
Standard response envelopecodemessagedata
dataobjectdata structure
idinteger

Withdrawal request id; used as app_id when changing the receiving card

order_idstring

Withdrawal order number; pass it when cancelling the withdrawal

stateinteger

Withdrawal request status:

  • 0 - Submitted and being processed
  • 1 - Processing
  • 2 - Rejected
  • 3 - Cancelled by the Client
  • 4 - Remitted
  • 5 - Failed
  • 6 - Refunded
  • 7 - Approved but not yet remitted
  • 8 - Under large-amount withdrawal review
  • 9 - Modification pending approval
  • 10 - Deletion pending approval
  • 11 - Deleted
  • 12 - Rejection pending approval
  • 15 - To be confirmed: the Client must confirm a change of the receiving bank card before processing continues

Only requests in status 0 or 15 can be cancelled. When displaying the status, prefer the returned state_description.

Values
0
1
2
3
4
5
6
7
8
9
10
11
12
15
amountstring

Withdrawal amount

currencystring

Withdrawal currency

feestring

Withdrawal fee

created_atinteger

Creation time as a Unix timestamp in seconds

updated_atinteger

Update time as a Unix timestamp in seconds; may be empty if never updated

namestring

Bank account holder name

bankstring

Receiving bank name

bank_enstring

Receiving bank name in English

accountstring

Receiving bank account number

swift_codestring

SWIFT code of the receiving bank

card_idinteger

Current receiving bank card id; a replacement card must differ from it

payee_addressobject

Payee address of a bank card

Child attributes
payee_countrystring

Payee country or region as an ISO 3166-1 alpha-3 code (for example, HKG), taken from code2 of “Get Payee Countries and Regions”

payee_statestring

State, province, or administrative region

payee_citystring

City

payee_streetstring

Street

payee_buildingstring

Building name; required only for some countries or regions

addressstring

Detailed address

payee_postcodestring

Postal code

admin_remarkstring

Remarks

statement_remarkstring

Statement remarks

can_edit_cardboolean

Whether the Client may change the receiving bank card; meaningful only when state is 0 or 15

to_be_changed_cardobject

Receiving bank card the review suggests the Client switch to. When returned, the Client must confirm and POST /v1/portfolio/withdraw/card/change/process must be called before the withdrawal continues. Absent when there is no suggestion

Child attributes
card_idinteger

Id of the suggested receiving bank card

bankstring

Bank name

bank_enstring

Bank name in English

accountstring

Bank account number

swift_codestring

Bank SWIFT code

recordsarray<object>

History of receiving card changes. The before of the record whose reversion is 0 is the original receiving card

Child attributes
reversioninteger

Change sequence number, increasing from 0

updated_atinteger

Change time as a Unix timestamp in seconds

beforeobject

Receiving card before the change

Child attributes
bankstring

Receiving bank name

accountstring

Receiving bank account number

afterobject

Receiving card after the change

Child attributes
bankstring

Receiving bank name

accountstring

Receiving bank account number

Whale Docs