Account, merchant and team

tilopay_switch_commerce

Shows the active merchant of the linked Tilopay account and lets you switch it when the account has several.

Parameters

Returns

{ selected, selected_name, commerces }

selected = active merchant id; selected_name = its name; commerces = [{ id, name }] available.

tilopay_unlink_account

Unlinks the Tilopay account from the assistant: revokes ALL access (WhatsApp, Claude and other applications), deletes the stored keys (including the bank ones) and closes the banking sessions. Before calling it with confirm=true, repeat that scope to the merchant and ask for confirmation. Use it when the merchant asks to unlink, disconnect or remove their account from the assistant.

Requires confirmation: Confirmations Tilopay requires

Parameters

Returns

{ unlinked, message }

unlinked = true when the account was unlinked.

tilopay_send_link_flow

Sends the merchant, on WhatsApp, the button to link (or relink) the Tilopay account with the assistant (only in the WhatsApp assistant). Use it for any request to link, connect or activate the assistant with the Tilopay account.

Parameters

No parameters.

Returns

tilopay_invite_employee

Invites an employee to use the assistant with their own Tilopay user (owner only). Asks for the employee's name and WhatsApp phone. Returns a wa.me link for the owner to send the invitation. In your answer, first repeat the `prerequisito` line verbatim and then deliver the link. The employee can query sales, create charges and send receipts; they cannot refund, charge stored cards, create or delete products, change prices or change the configuration.

Parameters

Returns

{ prerequisito, invite_id, expires_at, whatsapp_url }

prerequisito = the line the agent must repeat: the employee needs their own Tilopay user created at admin.tilopay.com › Usuarios; the invitation expires in 72 h.

tilopay_list_employees

Lists the employees with access to the assistant and the pending invitations (owner only).

Parameters

No parameters.

Returns

{ employees }

employees = [{ name, phone, status }]; the phone is masked and status is "activo" or "invitado".

tilopay_remove_employee

Removes an employee's access to the assistant (owner only): revokes their whole session, or cancels the invitation if they had not linked yet. Before calling it with confirm=true, confirm with the owner who is being removed.

Requires confirmation: Confirmations Tilopay requires

Parameters

Returns

{ removed }

removed = employees whose access was removed.

tilopay_accepted_payment_methods

Payment methods the merchant has enabled in Tilopay (card brands, SINPE, etc.), configured currencies and PayFac configuration. Use it for 'which cards do I accept?', 'is SINPE active?', 'can I charge in dollars?'.

Parameters

No parameters.

Returns

{ methods, currencies, payfac }

methods = accepted payment methods; currencies = currencies; payfac = PayFac configuration.

tilopay_panel_users

Users with access to the merchant's Tilopay web dashboard and their modules. Different from the assistant's employees (tilopay_list_employees).

Parameters

Returns