Actions5
Overview
This node interacts with the Telegram Stars payments API, enabling various payment-related operations within Telegram. Specifically, the 'Refund Star Payment' operation allows users to refund a successful payment made via Telegram Stars. This is useful for bot developers or service providers who need to manage payments, issue refunds, send invoices, respond to pre-checkout queries, retrieve transaction lists, or check the bot's star balance. For example, a bot selling digital goods can refund a user if a transaction was made in error.
Use Case Examples
- Refund a payment to a user by providing their user ID and the Telegram payment charge ID.
- Send an invoice to a chat for a product or service using Telegram Stars.
- Answer a pre-checkout query to approve or reject a payment before it is processed.
Properties
| Name | Meaning |
|---|---|
| User ID | Identifier of the user whose payment will be refunded. |
| Telegram Payment Charge ID | Telegram payment identifier used to specify the payment to refund. |
Output
JSON
user_id- The user identifier for whom the refund was processed.telegram_payment_charge_id- The Telegram payment charge ID associated with the refunded payment.status- Status of the refund operation, indicating success or failure.
Dependencies
- Requires an API key credential for Telegram Stars API authentication.
Troubleshooting
- Ensure that the User ID and Telegram Payment Charge ID are correctly provided and valid; otherwise, the refund request will fail.
- If the refund operation fails, check the error message returned by the Telegram API for details such as invalid identifiers or permission issues.
- Make sure the Telegram Stars API credentials are correctly configured and have the necessary permissions to perform refund operations.
Links
- Telegram Stars Payments API - Official Telegram documentation for the Stars payments API, including refund operations.