Crypto deposits & withdrawals

Transactions are the core entities in the Sentinal system, representing financial exchanges between parties.

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 allows the Payment Service Provider (PSP) and Exchanges to verify a crypto deposit transaction before processing it to a user's wallet. The system responds with the breakdown of the Value Added Tax (VAT), processing fees, and the net amount that can be settled to the client. Based on the client's overall standing, the transaction will either be approved or declined. If a transaction is declined, the PSP or Exchange should not proceed with the transaction.

POST /v1/payment/cryptoDeposit

Headers

Name
Type
Description

x-api-key*

string

Request Body

Name
Type
Description

ref*

string

External reference

totalAmount*

number

currency*

string

blochainHash*

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

PSP's transaction fee for the payment

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

Record crypto withdrawal

This endpoint allows the Payment Service Provider (PSP) and Exchanges to verify a crypto withdrawal transaction before processing it. The system responds with the breakdown of the Value Added Tax (VAT), processing fees, and the net amount that can be settled to the client. Based on the client's overall standing, the transaction will either be approved or declined. If a transaction is declined, the PSP or Exchange should not proceed with the transaction.

POST https://api.sentinal.network/v1/payment/cryptoWithdrawal

Headers

Name
Type
Description

x-api-key*

string

Request Body

Name
Type
Description

ref*

string

External reference

totalAmount*

number

currency*

string

blochainHash*

string

customer*

object

An object containing the customer details. An email is required, and you can also pass a name and phoneNumber

toAddress*

string

countryCode*

string

transactionFee*

number

PSP's transaction fee for the payment

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

Last updated