CmsWager Integration Document
  • Introduction
  • Before Start
  • Sportsbook UI
    • Integration
    • Window Message Events
  • CmsWager Api
    • Summary
    • Authentication
    • API Reference
      • Login/Register User
      • Freebet and Bonus assignment
    • Errors
  • Client API Reference
    • Summary
    • Api Reference
      • Bet placement
      • Cancelling bets
      • Concluding bets
      • Reopening concluded bets
      • Partial Cashout
      • Insurance
  • Frontend Api (optional)
    • Summary
    • Api Reference
      • Components
        • Top Leagues
        • Prematch Active Sports
        • Prematch Sport Menu
        • Last minute
        • Live now (reduced)
      • Matches
        • Tournament Odds
        • Match Odds
  • Appendix
    • Transaction types
    • Bet Status
    • Bet Type
    • Error Codes
Powered by GitBook
On this page
  1. Client API Reference
  2. Api Reference

Cancelling bets

POST {clientApi}/ticket/cancel

When a ticket is canceled on the Cmswager side, either by the player himself or the manager, a `ticket/cancel` request will be sent to the client system.

After canceling the ticket the deposit amount should be added to the user balance. The ticket then should be updated to the status indicated in the request. And if the cancellation is successful, the deposit amount should be refunded to the user.

If this request encounters a server error, it will be retried for 24 hours until it gets a meaningful response

If the new status (in request) is the same of the client system, no action need to be taken in client system and a 200 response must be returned.

"cancelling bet" request will be sent only for tickets with status "0" (in running). If the ticket status on client side is different from "0" please response with failiure "406" code. This means that a previous "Reopening concluded bet" message was sent and has not been processed

Example Request

{
  "clientId": "xyzk",
  "userId": 123456,
  "transactionType": 1,
  "amount": 10.56,
  "ticket": {
    "id": 123456,
    "code": "abcd1234",
    "amount": 10.56,
    "isBonus": false,
    "isFreebet": false,
    "freebetId": 0
  },
  "code": 2021,
  "reason": "ticket_canceled"
}

Example Success Response

Response code 200

After the deposit amount is added to user balance and the ticket is setted to "canceled" in client system, a 200 success response should be returned.

{    
    "status": "success",
    "balance": 140.85,
    "error_code": 0,
    "error_message": ""
}

Example Failure Response

Response code 406

If there is any error in client system, a 406 response cose should be returned

{
    "status": "error",
    "balance": 140.85,
    "error_code": 2001,
    "error_message": "client error"
}
PreviousBet placementNextConcluding bets

Last updated 1 month ago