Deposits & Withdrawals

They capture essential details about the monetary amount, the involved client, the country of operation, and the applied fees. Transactions also maintain a status indicating their current state, such as "APPROVED" or "DECLINED".

Record crypto deposit

This endpoint records a deposit into a customer’s gaming account. The system validates the transaction, calculates VAT and fees, and returns the net credited amount with an approval or decline status.

POST /v1/payment/deposit

Headers

Name	Type	Description
x-api-key*	string

Request Body

Name	Type	Description
ref*	string	External reference
totalAmount*	number
currency*	string
customer*	object	An object containing the customer details. An email is required, and you can also pass a name and phoneNumber
countryCode*	string
transactionFee*	number	Transaction fee for the payment

200: OK Transaction recorded successfully

{
    "success": true,
    "message": "Transaction recorded successfully.",
    "content": {
        "transactionId": "WBzywJCj9D8Kago2dDFj",
        "vatAmount": 11.2875,
        "processingFee": 0.4214,
        "netAmount": 138.7911,
        "status": "APPROVED",
        "ref": "12345"
    }
}

Record withdrawal

This endpoint records a withdrawal request from a customer’s gaming account. The system validates the transaction, calculates VAT and fees, and returns the net disbursed amount with an approval or decline status.

POST /v1/payment/withdrawal

Headers

Name	Type	Description
x-api-key*	string

Request Body

Name	Type	Description
ref*	string	External reference
totalAmount*	number
currency*	string
customer*	object	An object containing the customer details. An email is required, and you can also pass a name and phoneNumber
toAddress*	object	An object containing the customer banking details.
countryCode*	string
transactionFee*	number	Transaction fee for the payment

200: OK Transaction recorded successfully

{
    "success": true,
    "message": "Transaction recorded successfully.",
    "content": {
        "transactionId": "WBzywJCj9D8Kago2dDFj",
        "vatAmount": 11.2875,
        "processingFee": 0.4214,
        "netAmount": 138.7911,
        "status": "APPROVED",
        "ref": "12345"
    }
}

Compliance & Audit

All deposits, withdrawals, wagers, and payouts are recorded in a secure, system to support tax reporting, fraud detection, and gaming compliance. Sentinal® supports national regulatory frameworks and provides full audit trails for inspection by gaming authorities and licensing bodies.

By integrating with the Sentinal® platform, gaming operators ensure full transparency across customer funds and transactions, enabling trust with both regulators and players.