cards

Check the card issuer link

Reports whether this account has linked the card issuer, the one-time setup every reloadable card route needs first. Until it is linked, those routes answer 400 with No card issuer account is linked to this wallet.

status is one of not_started, code_sent, linked, or kyc_required. Linking is held to Laso identity verification, so an account that has not linked and is not verified reads kyc_required, with a kyc_url to hand the account holder.

The account holder, never the agent, receives and enters the code. Send your human to their own inbox (or phone) and have them type the code into your interface. Never try to read the account holder's email or messages yourself, and never ask for their email password or access.

This route is free.

get/get-card-issuer-status

Request

  • Base URL: https://laso.finance
  • URL: https://laso.finance/get-card-issuer-status
  • Auth: API key in header Authorization

Response

The link status.

status'not_started' | 'code_sent' | 'linked' | 'kyc_required' required

not_started: no link in progress. code_sent: a code is waiting for the account holder. linked: done. kyc_required: the account must complete Laso identity verification first.

channel'email' | 'phone'

code_sent only. Where the code went.

sent_tostring

code_sent only. The destination, masked (e.g. j***@e***.com). The full address is never returned.

expires_atinteger

code_sent only. When the code stops working, in milliseconds since the epoch. Codes last 10 minutes.

attempts_leftinteger

code_sent only. Incorrect entries still allowed before this code is discarded.

linked_atinteger nullable

linked only. When the link was made, in milliseconds since the epoch.

kyc_urlstring nullable

kyc_required only. A one-time identity-verification link to hand the account holder.

notestring required

What to do next.

Changes

No recorded changes to this operation across all 3 revisions of this API.