Skip to content
Withdrawals

Update Payee Address of Bank Card

Saves the payee address of the given bank card. Used to add the address in the withdrawal page, the receiving card change flow, and the suggested card change flow. The change takes effect immediately without review; submitting the same address as the saved one changes nothing.

Call POST /v1/portfolio/withdraw/card/addresscheck first to get want_fields. All 7 fields of address must be present; pass an empty string for fields not in want_fields. After saving, call POST /v5/portfolio/withdraw to submit the withdrawal, or continue with the card change endpoint. On failure, show message to the Client and retry after correcting the input.

POSThttps://api.lbkrs.com/v1/portfolio/withdraw/card/address

Request body application/json

card_idintegerrequired

Bank card id

addressobjectrequired

Payee address; all 7 fields are required, with an empty string for fields that are not needed

Child attributes
payee_countrystringrequired

Country or region as an ISO 3166-1 alpha-3 code, from code2 of “Get Payee Countries and Regions”

payee_statestringrequired

State, province, or administrative region; up to 35 characters

payee_citystringrequired

City; up to 30 characters

payee_streetstringrequired

Street; up to 70 characters

payee_buildingstringrequired

Building name; up to 35 characters

addressstringrequired

Detailed address; up to 70 characters

payee_postcodestringrequired

Postal code; up to 16 characters

Responses

HTTP 200The request succeeded. The response body contains the result of the “Update Payee Address of Bank Card” operation.
codeintegerrequired

Business status code, 0 indicates success

messagestringrequired

Human-readable result or error message.

Whale Docs