Action 81: Cancel Spribe Free Spin Reward Event

Function Description

This action is dedicated to the Spribe game provider and can only be used to cancel a free spin reward event created via Action 80.
eventId must be the same identifier used when the event was created via Action 80. The system locates the event by this eventId and cancels it.
eventId must be a valid UUID v4 format (8-4-4-4-12 hexadecimal characters). It is used as the idempotency key:
- If the same eventId is sent again and the event has already been cancelled successfully, the system will not cancel it again and will return the same eventId.
- If the previous request with the same eventId did not complete successfully, the system will perform the cancellation with this eventId and return it.
If the event has already been paid, it cannot be cancelled.
If the eventId does not correspond to any existing event, the request will be rejected.
A successful response returns the eventId of the cancelled event.

Parameter

Parameter	Format	Mandatory	Description
action	Integer	Y	81
ts	Long	Y	Current system time
parent	String(50)	Y	Agent ID
eventId	String(36)	Y	Free Spin Reward Event Identifier (UUID v4 format, e.g. `550e8400-e29b-41d4-a716-446655440000`) `Must be the same eventId used when creating the free spin reward event via Action 80. Used as the idempotency key: if the event has already been cancelled successfully, no re-cancellation is performed and the same eventId is returned.`

Example


{
  "action": 81,
  "ts": 1711555200000,
  "parent": "testag",
  "eventId": "550e8400-e29b-41d4-a716-446655440000"
}

Return Results

Parameter	Format	Description
status	String(4)	Success: 0000 Error: See Error Codes in Appendix
data	String	The `eventId` of the cancelled free spin reward event
err_text	String(255)	Error message

Operation Sample


// Http Request
http://{API_Address}/apiRequest.do?dc=jb1&x=y1wayxScczy6ABfElfaVwb5CdfHxBN_JGtxyBSvpohLQakP8M2QSetJNojJBzvnrVChhq8YWWgBTdGeXFTH4vSNQQ66epf4NqYeQ-6bJ15pvHctQjQevulv7GHqOifuju_gY0H54FfVdQc9D5tKh1AZ-9KDh9dwcGSszZxU7JOOoHdYITlCO5LhvGmHxPBwZ
 
// Http Response (success)
{
    "status": "0000",
    "data": "550e8400-e29b-41d4-a716-446655440000"
}
 
// Http Response (failed)
1. If necessary parameters are not provided or do not meet the requirement, for example: eventId, then:
{
    "status": "8000",
    "err_text": "The parameter of input error, please check your parameter is correct or not. parameter:eventId is required"
}
 
2. If the free spin reward event does not exist (no event matches the given eventId):
{
    "status": "9998",
    "err_text": "Event [550e8400-e29b-41d4-a716-446655440000] not found."
}
 
3. If the free spin reward event has already been paid and cannot be cancelled:
{
    "status": "9998",
    "err_text": "Event [550e8400-e29b-41d4-a716-446655440000] is already paid, cannot be cancelled."
}