Complete deposit transaction

POST

/v1/transactions/custody-bank/deposit/complete

Completes money transfer after bank confirmation.

Idempotency behavior:

If BankTranID was already processed successfully, API returns the existing nilpayTranRef.

Request

Authorization

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

API Key

Add parameter in header

X-Signature

Example:

X-Signature: ********************

API Key

Add parameter in header

X-Timestamp

Example:

X-Timestamp: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

cURL

Full deposit completion with depositor infoMinimal deposit completion without depositor

curl --location 'https://api.dev.pynil.com/v1/transactions/custody-bank/deposit/complete' \
--header 'Authorization: Basic <encoded-value>' \
--header 'X-Signature: <api-key>' \
--header 'X-Timestamp: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "walletNumber": "101000030",
    "currency": "SDG",
    "amount": 500,
    "depositor": {
        "fullName": "Layla ismaeil",
        "mobile": "0918003874",
        "idNumber": "1001-1090-180",
        "address": "Khartoum - sudan"
    },
    "BankTranID": "41128",
    "timestamp": "2025-08-03",
    "notes": "Layla deposits money"
}'

Response Example

200 - Successful completion response

{
    "success": true,
    "message": "Success.",
    "statusCode": 200,
    "data": {
        "nilpayTranRef": 6
    }
}

Initiate deposit transaction

Integration Guide