start_card_issuer_link
Send the account holder a code to link the card issuer
Starts the one-time card issuer link: the card issuer sends a one-time code to the account holder. Then call POST /verify-card-issuer-link with the code they enter.
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.
Where the code goes. An account with an email on file always gets the code at that email; email and phone are ignored for it. An account with no email (a wallet-only sign-in) must send exactly one of email or phone (E.164). The response names the destination masked, never in full.
Limits. Codes last 10 minutes. At most 5 codes can be sent per account in any rolling hour (429, with Retry-After). Sending a new code replaces the previous one, which then stops working.
Prerequisite: Laso identity verification (403 kyc_required otherwise, with a kyc_url). If the account is already linked, this answers 200 with status: linked and sends nothing, so calling it twice is safe.
This route is free.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "start_card_issuer_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Only for an account with no email on file. The account holder's email. | ||
| phone | No | Only for an account with no email on file, instead of `email`. E.164, e.g. `+15551234567`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| status | No | One of: code_sent, linked. | |
| channel | No | One of: email, phone. | |
| sent_to | No | The destination, masked. | |
| expires_at | No | When the code stops working, in milliseconds since the epoch. |