Xtrempay Api Documentation

Receive SageCloud webhook events

Cloud Mock

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

POST

/v1/webhook/core-banking/sagecloud

Maintainer:Not configured

Receives webhook notifications from SageCloud for various payment events.

Event Types:

transfer.success - Bank transfer completed successfully

transfer.failed - Bank transfer failed

virtualaccount.credit - Deposit received on virtual account (incoming payment)

Security:
The webhook payload is signed using HMAC-SHA512. The signature is provided
in the X-SageCloud-Signature header and must be verified before processing.

Request

Header Params

Body Params application/json

Examples

Transfer Success EventTransfer Failed EventVirtual Account Credit Event (Incoming Payment)

Notification when a bank transfer completes successfully

{
    "data": {
        "fee": "14",
        "date": "2026-01-21T10:19:16.000000Z",
        "type": "CREDIT",
        "amount": 70000.0,
        "source": {
            "bank_name": null,
            "account_name": "Ercas",
            "account_number": "0122675636"
        },
        "status": "SUCCESSFUL",
        "currency": "NGN",
        "receiver": {
            "bank_name": "wema",
            "account_name": "ERCAS-Village Assist /OMOJUWA",
            "account_number": "7170137864"
        },
        "bank_code": null,
        "bank_name": null,
        "narration": null,
        "reference": "999999260121111245856705423934",
        "session_id": null,
        "sender_bank": null,
        "account_name": null,
        "account_number": "7170137864",
        "settled_amount": 69986,
        "transaction_date": null,
        "sender_account_name": null,
        "sender_account_number": null,
        "virtual_account_number": null,
        "virtual_account_reference": null
    },
    "type": "VIRTUAL-ACCOUNT",
    "event": "VIRTUAL-ACCOUNT-INFLOW",
    "transferFailed": false,
    "transferSuccess": false,
    "virtualAccountCredit": true,
    "virtualAccountNumber": "7170137864"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Transfer Success EventTransfer Failed EventVirtual Account Credit Event (Incoming Payment)

curl --location --request POST 'https://mock.apidog.com/m1/918700-0-default/v1/webhook/core-banking/sagecloud' \
--header 'X-SageCloud-Signature: 3f2a3a3ec02647caa24377778ae7d77765a70435160f4fb6800b77cc77033f77' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "fee": "14",
        "date": "2026-01-21T10:19:16.000000Z",
        "type": "CREDIT",
        "amount": 70000.0,
        "source": {
            "bank_name": null,
            "account_name": "Ercas",
            "account_number": "0122675636"
        },
        "status": "SUCCESSFUL",
        "currency": "NGN",
        "receiver": {
            "bank_name": "wema",
            "account_name": "ERCAS-Village Assist /OMOJUWA",
            "account_number": "7170137864"
        },
        "bank_code": null,
        "bank_name": null,
        "narration": null,
        "reference": "999999260121111245856705423934",
        "session_id": null,
        "sender_bank": null,
        "account_name": null,
        "account_number": "7170137864",
        "settled_amount": 69986,
        "transaction_date": null,
        "sender_account_name": null,
        "sender_account_number": null,
        "virtual_account_number": null,
        "virtual_account_reference": null
    },
    "type": "VIRTUAL-ACCOUNT",
    "event": "VIRTUAL-ACCOUNT-INFLOW",
    "transferFailed": false,
    "transferSuccess": false,
    "virtualAccountCredit": true,
    "virtualAccountNumber": "7170137864"
}'

Responses

🟢200OK

application/json

Webhook processed successfully

Body

Example

{
    "status": 200,
    "message": "Webhook processed successfully",
    "data": "OK"
}

🟠401Unauthorized

🔴500Server Error

Modified at 2026-01-29 11:03:15

Set agent referral flag

Webhook health check