Xtrempay Api Documentation

Credit prizes to winners' wallets

Cloud Mock

https://mock.apidog.com/m1/918700-0-default

POST

/v1/trivia/challenges/{id}/credit-prizes

Maintainer:Not configured

Credits cash prizes to winners' wallets for a trivia challenge.

How it works:

Retrieves all winners from trivia_winners table for the challenge

For each winner with a prize amount > 0:

Publishes CashRewardWonEvent to RabbitMQ

Core Banking Service receives event and credits user's wallet

Creates transaction (type: SAVINGS, narration: "Spin & Win Cash Reward")

Updates account balance and ledger entries

Important Notes:

Winners must be processed first using /process-winners endpoint

This endpoint can be called multiple times safely (idempotent)

Each winner receives a CashRewardWonEvent with reference: trivia-challenge-{challengeId}-position-{position}

Prizes are credited asynchronously via message queue

Check transaction history to verify credits were successful

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://mock.apidog.com/m1/918700-0-default/v1/trivia/challenges/1/credit-prizes' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

Prizes credited successfully

Body

Example

{
    "timestamp": "2024-01-15T10:30:00Z",
    "status": 200,
    "success": true,
    "message": "Prizes credited successfully",
    "data": "Prizes have been credited for challenge 1"
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Modified at 2026-01-17 18:05:00

Process winners for a trivia challenge

Process winners and credit prizes in one operation