netfluid__fund_card_link
Mints a single-use hosted card-payment link (CARD_PAY). The wallet token never appears in any customer-facing URL.
Mints a single-use payment link for a wallet account and returns it in values.link (https://cards.netfluid.app/{session_id}). Hand the link to the payer: it serves the hosted payment page, takes new-card payments (3D Secure) and, with saved='1', saved-card payments, and becomes invalid once the payment completes. POST only — the API refuses GET (405) so the wallet token can never land in access logs; this tool posts a JSON body. The account must be a ZAR account and the wallet must be KYC verified. Idempotency: a non-empty reference maps to one open payment — retrying the same reference returns the same live link (values.reused=1); once the payment is terminal (paid/failed/expired) the reference frees for a new payment. values.expires_at is the unix time the link dies (24h default). @param api_key: The api key allocated to your application @param token: The wallet_api_token provided by /access/login @param wallet_fk: The wallet_fk @param account_fk: The account_fk (this is a database ID (int) not an account address (str) and may not be 0) The account_fk provided by /wallet/accounts_list (ZAR accounts only) @param amount: The fixed charge amount in the account currency (ZAR), between 10 and 100000. On top of this amount a fee with be charged equal to 3.5% for fees and insurance plus South African VAT of 15% (only on the fee portion). @param saved: '1' = owner-payer mode: the wallet's saved cards are offered on the page (tokenised recharge). Default '0' = link-payer mode: new card with 3D Secure. @param description: Shown to the payer on the hosted page (max 100 characters) @param reference: The caller's own reference; doubles as the idempotency key (max 100 characters) @param keep_card: '1' keeps a newly tokenised card after the payment. Default '0' — anonymous cards are removed after a successful charge. @param return_url: http/https URL the payer is returned to after the payment (max 500 characters, validated) @param webhook_url: https URL on a public host that receives a signed webhook when the payment completes (max 500 characters, validated) @param webhook_secret: HMAC-SHA256 signing secret for the webhook; generated when omitted (max 64 characters) @param ttl_s: Link lifetime in seconds, default 86400, clamped to 300-86400
@return: a json object
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"api_key": "<api_key>",
"token": "<token>",
"wallet_fk": "<wallet_fk>",
"account_fk": "<account_fk>",
"amount": "<amount>"
},
"name": "netfluid__fund_card_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| saved | No | ||
| token | Yes | ||
| ttl_s | No | ||
| amount | Yes | ||
| api_key | Yes | ||
| keep_card | No | ||
| reference | No | ||
| wallet_fk | Yes | ||
| account_fk | Yes | ||
| return_url | No | ||
| description | No | ||
| webhook_url | No | ||
| webhook_secret | No |