Simulate a dial

POST

/v1/datapin/b2b/simulate-dial

Loads a PIN programmatically without a physical phone dial. Works for both live and sandbox keys (db_live_ or db_test_): your wallet (or sandbox wallet) is charged, the order is sent to the network, and your webhook receives datapin.processing then datapin.delivered.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠400

🟠401

🟠403

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'http://localhost:5050/v1/datapin/b2b/simulate-dial' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pin": "123456789012",
    "phoneNumber": "08012345678",
    "network": "MTN",
    "environment": "live"
}'

Response Example

200 - Success

{
    "success": true,
    "message": "Request successful",
    "statusCode": 200,
    "path": "/v1/…",
    "timestamp": "2026-09-26T12:00:00.000Z",
    "hash": "a1b2c3d4-…",
    "data": {
        "ok": true,
        "code": "LOADING",
        "reference": "DB-DPL-20261006-MFX2K9QZ-5B1E0A47",
        "message": "Successful! Your 1GB · 30 days for 08012345678 is on its way."
    }
}

Modified at 2026-10-07 16:02:56

Disable one PIN

Get print layout customization