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. Integrate BETCORE Games
  • 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. Integrate BETCORE Games

Freebets

There are several scenarios for freebets:
issue via campaign
issue without campaign
issue and cancel.

Issue via campaign#

The partner creates a campaign via /v3/FreeBets/Campaign/Create and issues a freebet via /v3/FreeBets/Issue using the campaign_id parameter.
Bets, refunds, and payouts are processed via /payments/make.

Campaign creation#

bash
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: XXX" \
  -d '{
  "client_id": 6781234521,
  "campaign_id": "summer_fb_2026",
  "name": "Summer Freebet 2026",
  "bonus_type": "FreeBet",
  "quantity": 1,
  "valid_from": "2026-05-07T12:00:00Z",
  "valid_until": "2026-05-14T12:00:00Z",
  "games": ["game"],
  "bet_amounts": [
    { "currency": "EUR", "amount": "10.00" },
    { "currency": "USD", "amount": "11.00" }
  ],
  "duration_min": 1440,
  "config": {
    "bonus_limit": 1000,
    "bonus_limit_per_user": 1,
    "min_coefficient": "1.5",
    "max_coefficient": "10.0"
  }
}'

Issue via campaign#

bash
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: XXX" \
  -d '{
  "issue_id": "648056e4-5064-40bd-9c34-8ab31c628a91",
  "campaign_id": "summer_fb_2026",
  "account_id": "8821415121",
  "is_test": false,
  "client_id": 6781234521,
  "currency": "EUR",
}'

Acceptance of a bet (TransactionType = -1)#

json
  "data": {
    "Amount": "0",
    "BetId": 228784,
    "PartnerUserId": "8821415121",
    "TransactionType": -1,
    "IssueId": "648056e4-5064-40bd-9c34-8ab31c628a91",
    "BonusType": "FreeBet",
    "PromoCode": "2234612623"
  }
}

Payout (TransactionType = 1)#

json
  "data": {
    "Amount": "25.00",
    "BetId": 228784,
    "PartnerUserId": "8821415121",
    "TransactionType": 1,
    "IssueId": "648056e4-5064-40bd-9c34-8ab31c628a91",
    "BonusType": "FreeBet",
    "PromoCode": "2234612623"
  }
}

Loss (TransactionType = 1, Amount = 0)#

json
  "data": {
    "Amount": "0",
    "BetId": 228784,
    "PartnerUserId": "8821415121",
    "TransactionType": 1,
    "IssueId": "648056e4-5064-40bd-9c34-8ab31c628a91",
    "BonusType": "FreeBet",
    "PromoCode": "2234612623"
  }
}

Issue without campaign#

The partner issues a freebet via /v3/FreeBets/Issue, passing all parameters in the request.
Transactions via /payments/make — similar to the issue with campaign flow.
bash
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: XXX" \
  -d '{
  "issue_id": "648056e4-5064-40bd-9c34-8ab31c628a91",
  "account_id": "8821415121",
  "is_test": false,
  "client_id": 6781234521,
  "currency": "EUR",
  "quantity": 1,
  "bonus_type": "FreeBet",
  "games": ["game"],
  "amount": "10.00",
  "duration_min": 1440,
  "config": {
    "min_coefficient": "1.5",
    "max_coefficient": "10.0"
  }
}'

Issue and cancel#

The partner issues a freebet, then cancels it using /v3/FreeBets/Cancel.

Issue#

bash
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: XXX" \
  -d '{
  "issue_id": "648056e4-5064-40bd-9c34-8ab31c628a91",
  "account_id": "8821415121",
  "is_test": false,
  "client_id": 6781234521,
  "currency": "EUR",
  "quantity": 1,
  "bonus_type": "FreeBet",
  "games": ["game"],
  "amount": "10.00",
  "duration_min": 1440,
  "config": {
    "min_coefficient": "1.5",
    "max_coefficient": "10.0"
  }
}'

Cancel#

bash
  -H "Content-Type: application/json" \
  -H "X-REQUEST-SIGN: XXX" \
  -d '{
  "issue_id": "648056e4-5064-40bd-9c34-8ab31c628a91",
  "client_id": 6781234521
}'
Previous
Promotional campaigns
Next
BETCORE API
Built with