Skip to content

Extend transaction information

If you need to get more information about bet in transaction, you should request GR8 project manager / account manager, to enable this in transaction request.

Examples:

Simple transaction request

{
    "id": "d193c323-e9fc-4952-bc74-0ca17071137b_1740486677645468_1",
    "currency": "EUR",
    "platform": "sport",
    "type": "deposit",
    "createdAt": "2025-02-25T12:31:17Z",
    "initiatedAt": "2025-02-25T12:31:17Z",
    "context": {
        "bet": {
            "betOdd": 5.8
        },
        "product": "sportsbook",
        "reason": "settle",
        "betId": "d193c323-e9fc-4952-bc74-0ca17071137b",
        "SportBonusOfferId": "",
        "SportBonusPlayerOfferId": "",
        "betAmount": 2.0002040608101216
    },
    "amountBreakdown": {
        "cash": 2.0,
        "locked": 0.0,
        "bonus": 0.0,
        "retract": 0.0,
        "tax": {
            "cash": 0.0,
            "locked": 0.0,
            "bonus": 0.0,
            "retract": 0.0
        }
    }
}

Extended wallet transaction with Bet information

{
    "id": "d193c323-e9fc-4952-bc74-0ca17071137b_1740486677645468_1",
    "currency": "EUR",
    "platform": "sport",
    "type": "deposit",
    "createdAt": "2025-02-25T12:31:17Z",
    "initiatedAt": "2025-02-25T12:31:17Z",
    "context": {
        "extras": {
            "bet": {
                "betType": "Express",
                "betOdd": 5.8,
                "items": [
                    {
                        "itemIndex": 0,
                        "eventStage": "Prematch",
                        "acceptedOdd": 2.9,
                        "event": {
                            "id": "12770432",
                            "eventName": "Bologna - AC Milan",
                            "sportTypeKey": "F",
                            "sportName": "Football",
                            "categoryId": "417acc9050e04117aff67d43981ed5b2",
                            "categoryName": "Italy",
                            "tournamentId": "6d80f3f3fa35431b80d50f516e4ce075",
                            "tournamentName": "Serie A",
                            "startTime": "2025-02-27T19:45:00Z",
                            "competitorType": "Team",
                            "competitors": [
                                {
                                    "id": "339901",
                                    "competitorName": "Bologna"
                                },
                                {
                                    "id": "339919",
                                    "competitorName": "AC Milan"
                                }
                            ]
                        },
                        "sourceOutcomes": [
                            {
                                "sourceOutcomeIndex": 0,
                                "selectionKey": "[2,[],[0],1,0,[]]",
                                "acceptedOdd": 2.9,
                                "result": "TechnicalReturn", <--- All possible results are below,
                                "marketName": "Full-time result",
                                "outcomeName": "Bologna"
                            }
                        ]
                    },
                    {
                        "itemIndex": 1,
                        "eventStage": "Prematch",
                        "acceptedOdd": 2.0,
                        "event": {
                            "id": "12793846",
                            "eventName": "Bologna - AC Milan",
                            "sportTypeKey": "F",
                            "sportName": "Football",
                            "categoryId": "417acc9050e04117aff67d43981ed5b2",
                            "categoryName": "Italy",
                            "tournamentId": "6d80f3f3fa35431b80d50f516e4ce075",
                            "tournamentName": "Serie A",
                            "startTime": "2025-03-02T14:00:00Z",
                            "competitorType": "Team",
                            "competitors": [
                                {
                                    "id": "348084",
                                    "competitorName": "Bologna"
                                },
                                {
                                    "id": "351979",
                                    "competitorName": "AC Milan"
                                }
                            ]
                        },
                        "sourceOutcomes": [
                            {
                                "sourceOutcomeIndex": 0,
                                "selectionKey": "[2,[],[0],1,0,[]]",
                                "acceptedOdd": 2.0,
                                "result": "TechnicalReturn",
                                "marketName": "Full-time result",
                                "outcomeName": "Bologna"
                            }
                        ]
                    }
                ],
                "result": "TechnicalReturn"
            }
        },
        "product": "sportsbook",
        "reason": "settle",
        "betId": "d193c323-e9fc-4952-bc74-0ca17071137b",
        "SportBonusOfferId": "",
        "SportBonusPlayerOfferId": "",
        "betAmount": 2.0002040608101216
    },
    "amountBreakdown": {
        "cash": 2.0,
        "locked": 0.0,
        "bonus": 0.0,
        "retract": 0.0,
        "tax": {
            "cash": 0.0,
            "locked": 0.0,
            "bonus": 0.0,
            "retract": 0.0
        }
    }
}
Json schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": [
    "id",
    "currency",
    "platform",
    "type",
    "createdAt",
    "initiatedAt",
    "context",
    "amountBreakdown"
  ],
  "properties": {
    "id": {
      "type": "string",
      "Unique transaction identifier"
    },
    "currency": {
      "type": "string",
      "The currency in which the transaction is conducted, e.g. 'USD', 'EUR'."
    },
    "platform": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "enum": [
        "deposit",
        "withdrawal",
        "rollback",
        "award",
        "release",
        "retract"
      ],
      "description": "Transaction type. Operation that should be performed with balance"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "An ISO 8601 timestamp in UTC, e.g. 2025-02-25T12:31:17Z"
    },
    "initiatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "An ISO 8601 timestamp in UTC, e.g. 2025-02-25T12:31:17Z"
    },
    "context": {
      "type": "object",
      "required": [
        "product",
        "reason"
      ],
      "properties": {
        "extras": {
          "type": "object",
          "properties": {
            "bet": {
              "type": "object",
              "required": [
                "betType",
                "betOdd",
                "items",
                "result"
              ],
              "properties": {
                "betType": {
                  "type": "string",
                  "enum": [
                    "Ordinar",
                    "Express",
                    "System"
                  ]
                },
                "betOdd": {
                  "type": "number"
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "itemIndex",
                      "eventStage",
                      "acceptedOdd",
                      "event",
                      "sourceOutcomes"
                    ],
                    "properties": {
                      "itemIndex": {
                        "type": "integer"
                      },
                      "eventStage": {
                        "type": "string",
                        "enum": [
                          "Prematch",
                          "Live"
                        ]
                      },
                      "acceptedOdd": {
                        "type": "number"
                      },
                      "event": {
                        "type": "object",
                        "required": [
                          "id",
                          "eventName",
                          "sportTypeKey",
                          "sportName",
                          "categoryId",
                          "categoryName",
                          "tournamentId",
                          "tournamentName",
                          "startTime",
                          "competitorType",
                          "competitors"
                        ],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "eventName": {
                            "type": "string"
                          },
                          "sportTypeKey": {
                            "type": "string",
                            "description": "The short 'sportName' ('F', 'TT', 'H'...)"
                          },
                          "sportName": {
                            "type": "string"
                          },
                          "categoryId": {
                            "type": "string"
                          },
                          "categoryName": {
                            "type": "string"
                          },
                          "tournamentId": {
                            "type": "string"
                          },
                          "tournamentName": {
                            "type": "string"
                          },
                          "startTime": {
                            "type": "string",
                            "format": "date-time",
                            "description": "An ISO 8601 timestamp in UTC, e.g. 2025-02-25T12:31:17Z"
                          },
                          "competitorType": {
                            "type": "string"
                          },
                          "competitors": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "required": [
                                "id",
                                "competitorName"
                              ],
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "competitorName": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      },
                      "sourceOutcomes": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "sourceOutcomeIndex",
                            "selectionKey",
                            "acceptedOdd",
                            "result",
                            "marketName",
                            "outcomeName"
                          ],
                          "properties": {
                            "sourceOutcomeIndex": {
                              "type": "integer"
                            },
                            "selectionKey": {
                              "type": "string"
                            },
                            "acceptedOdd": {
                              "type": "number"
                            },
                            "result": {
                              "type": "string"
                            },
                            "marketName": {
                              "type": "string"
                            },
                            "outcomeName": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "result": {
                  "type": "string",
                  "enum": [
                    "Unknown",
                    "Win",
                    "Lose",
                    "Return",
                    "Return025",
                    "Return075",
                    "TechnicalReturn",
                    "Cashout",
                    "DeadHeat"
                  ]
                }
              }
            }
          }
        },
        "product": {
          "type": "string"
        },
        "reason": {
          "type": "string",
          "enum": [
            "bet",
            "sport rollback",
            "settle",
            "resettle",
            "cancelsettle",
            "freebet award",
            "freebet release",
            "freebet",
            "rollback freebet",
            "settle freebet",
            "resettle freebet",
            "cancelsettle freebet",
            "bonus award",
            "bonus release",
            "bonus limit release",
            "partial settle",
            "partial resettle",
            "partial cancelsettle"
          ]
        },
        "betId": {
          "type": "string"
        },
        "SportBonusOfferId": {
          "type": "string"
        },
        "SportBonusPlayerOfferId": {
          "type": "string"
        },
        "betAmount": {
          "type": "number"
        }
      },
      "additionalProperties": true
    },
    "amountBreakdown": {
      "type": "object",
      "required": [
        "cash",
        "locked",
        "bonus"
      ],
      "properties": {
        "cash": {
          "type": "number"
        },
        "locked": {
          "type": "number"
        },
        "bonus": {
          "type": "number"
        },
        "retract": {
          "type": "number"
        },
        "tax": {
          "type": "object",
          "required": [
            "cash",
            "locked",
            "bonus"
          ],
          "properties": {
            "cash": {
              "type": "number"
            },
            "locked": {
              "type": "number"
            },
            "bonus": {
              "type": "number"
            },
            "retract": {
              "type": "number"
            }
          },
          "additionalProperties": true
        }
      }
    }
  },
  "additionalProperties": true
}

All available RESULTS:

  • Unknown
  • Win
  • Lose
  • Return
  • Return025
  • Return075
  • TechnicalReturn
  • Cashout
  • DeadHeat

Warning

Transactions are not performed during placing open bets.