Creates a payment wallet.
Payment wallets are a form of sub-wallet of which the sponsor controls access to the Secret,PIN and recovery keywords.
A payment wallet cannot login to the portal and is therefore only accessible to the sponsor via the api or this mcp.
In order for this wallet to exists, it needs to be created by a human KYCed wallet.
Once created this wallet will be fully enabled to perform any transaction any other wallet is capable of.
Including access to virtual bank accounts in Europe and the USA as a funding source.
The wallet is automatically minted with a Solana Blockchain wallet.
The sponsor would typically only need to save the wallet_fk and PIN of the new wallet in their storage in order to make use of it later.
The secret is optional purely to maintain backward compatibility, if not provided the system will generate default values.
We suggest you use the mobile and email of the sponsor where available, in order to get access to recovery methods.
The human accepts all legal responsibility for this payment wallet.
Process can take up to 30 seconds.
@param secret: A secret, minimum 8 characters, must be unique system-wide. This is typically the username, but private.
Suggestion: Generate 3 natural language words, concatenated, or prompt the human for 3 words.
@param pin: The 5 digit PIN associated with the new wallet. Can be any random 5 numbers.
@param email: The agents email address, if not available use a blank string.
@param mobile: The human's mobile phone number, in e164 format, e.g. 27821234567 (no +). if not available use a blank string.
@param currency_fk: The currency of the first account, use 7 (ZAR) for everyone else use 3 (USD)
@param sponsor_wallet_fk: The sponsor's wallet_fk, this wallet_fk must be KYCed if not the new wallet will also not be KYCed
@param sponsor_wallet_pin: The sponsor's 5-digit PIN
@return: a json object