Payment links and statuses

The application provides two separate agent actions: create a payment link and check a stored order status.

Creating a link

The link creation tool uses only the account, items, and prices from the tool instance settings. Senler automatically supplies the project, agent, channel, conversation, and lead context; the customer does not need to provide these service values.

The application creates a unique order_id, sends it to Prodamus as the order number, and returns the payment link to the agent. The new order immediately receives pending: the link is ready, but no payment confirmation has arrived.

A technical retry with the same event identifier does not create a second order. A new intentional tool call creates a new link and a new order_id.

Confirming payment

A customer redirect to a successful payment page is not confirmation. The application changes the status only after a signed Prodamus webhook and verifies the store, order number, signature, and amount.

After confirmation, the application stores the payment and emits a payment.paid Senler event for the agent and conversation in which the link was created. The event contains the order ID, amount, currency, and order items. This becomes internal agent context and is not shown to the customer as a separate technical message.

The agent reacts only when the “Payment confirmed” event is enabled in its settings. The agent instruction determines the reply and any follow-up actions. A repeated webhook cannot produce a duplicate reaction because Prodamus and Senler use a stable event identifier.

Checking the status

The status tool returns the stored order_id, status, paid, amount, and payment link. It reads the application state and does not make a new Prodamus request on every call.

The agent must pass the order_id returned by the payment-link tool. The order must belong to the current project and conversation. The application does not select an order from conversation history automatically.

Interpreting the result

Value	Meaning	Action
pending	The link exists, but no verified payment has arrived	Ask the customer to complete payment or check again later
paid: true	The signed notification and amount were verified	Continue the paid scenario

Do not treat a screenshot, customer message, or success page as proof of payment. Use only the status stored by the tool.