Bless account (sandbox only)

Available only when wrapper upstream is sandbox. Requires mobile_number and amount.

Account API access is restricted

Portal-created sandbox test app accounts do not grant your project direct Account API access.

If your project is not approved for Account API access, /account/* calls return HTTP 403 with PW_ACCOUNT_ACCESS_REQUIRED.

See /getting-started/sandbox-account-setup.

Endpoint

POST /account/bless_account

Query Parameters

version (string, required) - API contract version. Use exactly 2024-10-01.
diagnostics (boolean, optional) - Non-production docs only. Set true to include extra diagnostic metadata (for example observed_client_ip).

Header Parameters

PW-subscription-key (string, required)
PW-origin-country (string, required)
PW-request-date (string, required) - UTC request timestamp formatted as YYYY-MM-DD HH:mm:ss.
PW-ip-address (string, required)
User-Agent (string, required)

Header Constraints

Key	Description	Example	Data type	Requirement	Field Length
`PW-subscription-key`	Developer key available after portal registration. Production key is shared on request.	`eed0d85c530c4b26a91d09b783d8fab3`	`string`	`mandatory`	`32`
`PW-origin-country`	ISO Alpha-2 country code where the transaction is created.	`TT`	`string`	`mandatory`	`2`
`PW-request-date`	Current request timestamp. Format: `YYYY-MM-DD HH:mm:ss` (UTC).	`2014-10-08 16:01:31`	`string`	`mandatory`	`19`
`PW-ip-address`	Fixed institution IP used for PayWise network-level validation.	`255.255.255.255`	`string`	`conditional`	`8-16`
`User-Agent`	In programmable environments, this avoids running into Cloudflare issues.	`Mozilla/5.0 (Windows NT 10.0; Win64; x64)`	`string`	`mandatory`	`255`

Request Body

{
  "mobile_number": "+18681234567",
  "amount": "25.00"
}

Downloads

Responses

200 - Wrapper-normalized response envelope (success cases).

Example: success

{
  "status": "success",
  "code": 200,
  "message": "Funds credited successfully",
  "request_id": "123e4567-e89b-12d3-a456-426614174001",
  "timestamp": "2026-08-23T01:29:16.000Z",
  "balance": "525.00"
}

Notes

This endpoint page is generated from openapi/pw-wrappers.2024-10-01.yaml.

Endpoint​

Query Parameters​

Header Parameters​

Header Constraints​

Request Body​

Downloads​

Responses​

200 - Wrapper-normalized response envelope (success cases).​

Example: success​

Notes​