BETCORE Aggregator
Provider IntegrationCasino IntegrationFeed Integration
Provider IntegrationCasino IntegrationFeed Integration
Visit Betcore website
Follow Betcore on Instagram
Follow Betcore on LinkedIn
Follow Betcore on Youtube
  1. Payments
  • PLEASE READ: Getting Started
  • Integrate BETCORE Games
    • Integrate BETCORE Games
    • WebFrame Connection
    • Promotional campaigns
    • Freebets
    • BETCORE API
      • Authentication
        • Token
          POST
        • Verify
          POST
        • Jwks
          GET
      • Payments
        • Accept
          POST
      • Rollbacks
        • Make
          POST
        • Accept
          POST
      • Cashback
        • Accept
          POST
    • PROMO API
      • Signing of server requests
      • FreeBets
        • Campaign/Create
          POST
        • Issue
          POST
        • Cancel
          POST
    • PARTNER API
      • Users
        • Auth
          POST
        • Data
          POST
      • Payments
        • Info
          POST
        • Make
          POST
        • Make-list
          POST
        • Close
          POST
      • Cashback
        • Make
          POST
  • Integrate YOUR Games
    • Integrate as Games Provider
    • PARTNER API
      • Games
        • Games
          GET
        • Launch
          POST
    • BETCORE API
      • Get Balance
        • Balance
          GET
      • Bets
        • PayIn
          POST
        • PayOut
          POST
        • PayInOut
          POST
        • Refund
          POST
  • Feed Integration
    • Feed Integration
    • REST API
      • Authorization
        • Token
          POST
      • Games
        • List
          GET
        • Info
          GET
        • Translations
          GET
      • Jackpot
        • Accumulated
          GET
    • Websocket
      • SubOnWholeGamesInfo
  1. Payments

Make

POST
{partners-api-host}/payments/make

Refund#

Refund is a transaction of returning money to the player, initiated by BETCORE after a successful charge. A refund means that the bet was accepted and the money was charged, but then it must be returned for one of the following reasons: cancellation of a bet based on business rules, technical error on the game side, service unavailability, etc.
A refund is provided only for transactions with TransactionType: -1 (Acceptance of a bet). BETCORE sends a request with TransactionType: 2 (Return of the bet) and a Amount parameter equal to the Amount parameter of the original transaction.

Automatic refund#

BETCORE supports custom configuration for an automatic /rollbacks/make method invocation when specific responses are received for a /payments/make request with TransactionType: -1. For example, the invocation may be called in the event of the following errors:
  • no response (connection timeout)
  • HTTP status 400
  • HTTP status 500
  • 103799: General API error.
The set of conditions is customizable: you can add or modify the error codes and types that the method /rollbacks/make will be called in.

JWT payload#

The request body is a JWT token. The data field contains a JSON string where:
ParameterData typeDescriptionMandatory
AmountstringAmount in player's currency.Yes
TaxAmountstringTax amount. The field is included in the request if the Tax On/Off setting is enabled in the BETCORE BackOffice.No
BetIdnumberBet id.Yes
PartnerUserIdstringPartner's user id.Yes
TransactionTypenumberTransaction type:
-1: Acceptance of a bet
1: Payout (sum 0 means loss)
2: Return of the bet
-2: Payback
4: Jackpot payout		Yes
PromoCodestringInternal bonus identifier.No
issueIdstringExternal issue id. Applies only to bets placed via external referrals.No
TagIduint32iFrame identification tag.No

JWT payload example#

{
  "nbf": 1626346401,
  "exp": 1626346411,
  "iss": "https://tvbetapiproxy.top/identity-api",
  "data": "{\"Amount\":\"200\",\"TaxAmount\":\"0\",\"BetId\":170253300,\"PartnerUserId\":\"SomeUserId100\",\"TransactionType\":-1}",
  "client_id": "PartnerClient-1556"
}

Transaction type, promo code and amount#

How the Amount parameter is populated when the PromoCode parameter is provided depends on the transaction type:
Transaction typeTransactionTypeAmount
Acceptance of a bet-10
Return of the bet20
Payout1Net winnings excluding the stake

Request

Path Params

Body Params application/json

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

⚪103752Invalid request parameters
⚪103811JWT token validation failed
⚪103805Invalid token
⚪103799General API Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://partners-api-host/payments/make' \
--header 'Content-Type: application/json' \
--data '"eyJhbGciOiJSUzI1NiIsImtpZCI6IkQyNTk5NTU5REMxNkI5NkZGNkU5OTI2NkQ2MTdBMDgyQjk2MjdDNUEiLCJ0eXAiOiJKV1QiLCJ4NXQiOiIwbG1WV2R3V3VXXzI2WkptMWhlZ2dybGlmRm8ifQ.eyJuYmYiOjE2MjYzNDY0MDEsImV4cCI6MTYyNjM0NjQxMSwiaXNzIjoiaHR0cHM6Ly90dmJldGFwaXByb3h5LnRvcC9pZGVudGl0eS1hcGkiLCJkYXRhIjoie1wiQW1vdW50XCI6XCIyMDBcIixcIlRheEFtb3VudFwiOlwiMFwiLFwiQmV0SWRcIjoxNzAyNTMzMDAsXCJQYXJ0bmVyVXNlcklkXCI6XCJTb21lVXNlcklkMTAwXCIsXCJUcmFuc2FjdGlvblR5cGVcIjotMX0iLCJjbGllbnRfaWQiOiJQYXJ0bmVyQ2xpZW50LTE1NTYifQ.V8tAtUPTNDY1a8zyosWLP54Ud_oQSYTrnOyvYbkeW9NxPJ_jqfRI9BbMRZX6qhr3JokoH8Sa3niV-Nti3ogZ_bs-QJe9fNZdvq8vdIVJRPeIV6AJ20n5iVSxc6UHCeh0JNhBilWT4Lw_kWW70xRVHFLo4H7XZD8SvFGD2u6cPCPkVSwvmMkCi2Aa_Z8wcriyLJBaV3lVq0c0V9_DmUSnmNFfWr7A9Orzbii9r2MZX6YCdhjWToP71TMcLUhtPCYebhXLCijUGdxn6dNNlrpOoQmwVsiUsGQD8m3bSn6Qb_ZAtLw7DFXz7AACai31p2Dmy7fZZ99uzT9mJCeMIgKzSABDeapGwJqvPC90waxMOj49DhrjZK5_OkCSSv2RYI2ZFF9OQ0wmbr30_PWHN6X-Ev7U-Qacr7x-BFpTa2vePmfo1EPm3ho28akzRFeYdlFkePapwYKY1qQTV-jFPtG4cq8lXNngiYU9bw7jzJzCpflJvUQYQsDM5-SuhA0-5RLM4nlM0A3wl7UWhlJyh6kmDFkTNbR_KTzEYNCSzIhllaIjpfoXB4IpFJMVnCMyIfZnJ5koXDwUIHmgpzZV9tyosWcY7852D9zLYd3rAt3POWRHkR7LGHy2QQI2yvdxYOJd1lShm_MvFguVF0maAD1sFUknNYKSwdpUTFVVmRH1JhA"'
Response Response Example
200 - Success
{
    "ErrorCode": 200,
    "Message": "Success"
}
Previous
Info
Next
Make-list
Built with