PaymentCallbacksApi
All URIs are relative to https://business.apis.kesk.app/v1
| Method | HTTP request | Description |
|---|---|---|
| handleOrderPaymentCallback | GET /payment-callback/order | Handle payment gateway callback for order transactions. |
| handleSubscriptionPaymentCallback | GET /payment-callback/subscription | Handle payment gateway callback for subscription payment transactions. |
| handleWalletPaymentCallback | GET /payment-callback/wallet | Handle payment gateway callback for wallet top-up transactions. |
handleOrderPaymentCallback
RedirectResponse handleOrderPaymentCallback(code, status, reference, hash, rep_status)
Handle payment gateway callback for order transactions.
Processes the payment result from the gateway after an order payment attempt. Updates order payment status and returns a redirect URL to display the payment result to the user.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| code | String | Payment gateway response code. | [optional] [default to null] |
| status | String | Payment status from the gateway (e.g., “Pagado”, “Autorizada”). | [optional] [default to null] |
| reference | String | Transaction reference or order identifier. | [optional] [default to null] |
| hash | String | Security hash for verifying callback authenticity. | [optional] [default to null] |
| rep_status | String | Additional status information from the payment gateway. | [optional] [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
handleSubscriptionPaymentCallback
RedirectResponse handleSubscriptionPaymentCallback(code, status, reference, hash, rep_status)
Handle payment gateway callback for subscription payment transactions.
Processes the payment result from the gateway after a subscription payment or renewal attempt. Activates or extends subscriptions on success, or marks them as failed for retry, then returns a redirect URL.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| code | String | Payment gateway response code. | [optional] [default to null] |
| status | String | Payment status from the gateway (e.g., “Pagado”, “Autorizada”). | [optional] [default to null] |
| reference | String | Transaction reference for the subscription payment. | [optional] [default to null] |
| hash | String | Security hash for verifying callback authenticity. | [optional] [default to null] |
| rep_status | String | Additional status information from the payment gateway. | [optional] [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8
handleWalletPaymentCallback
RedirectResponse handleWalletPaymentCallback(code, status, reference, hash, rep_status)
Handle payment gateway callback for wallet top-up transactions.
Processes the payment result from the gateway after a wallet top-up attempt. Updates wallet balance on success or marks the transaction as failed, then returns a redirect URL.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| code | String | Payment gateway response code. | [optional] [default to null] |
| status | String | Payment status from the gateway (e.g., “Pagado”, “Autorizada”). | [optional] [default to null] |
| reference | String | Transaction reference for the wallet top-up. | [optional] [default to null] |
| hash | String | Security hash for verifying callback authenticity. | [optional] [default to null] |
| rep_status | String | Additional status information from the payment gateway. | [optional] [default to null] |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json; charset=utf-8