Mobile money transfer objects
Last updated: 2026-07-17
Direct mobile-money-transfer pay-ins send
mobileMoneyTransferDetails in the create request and can receive an object with
the same JSON field name in the create response.
Request details
| Field | JSON type | Presence | Merchant meaning |
|---|---|---|---|
operator | string | Required (actual) | Transfer rail code returned by pay-in operator discovery |
mobileNumber | string | Required (actual) | Customer mobile wallet number or MSISDN |
The request must not include bank, standard mobile-money, or test detail blocks for this payment method.
Response details
| Field | JSON type | Presence | Merchant meaning |
|---|---|---|---|
instructions | array | Optional | Ordered customer payment instructions |
expiresAt | string (date-time) or null | Optional | Instruction expiry |
displayMessage | string | Optional | Customer-facing next-step text |
providerReference | string | Optional | Transfer reference returned for customer-facing display |
Each instruction contains:
| Field | JSON type | Merchant meaning |
|---|---|---|
key | string | Stable instruction key |
label | string | Display label |
value | string | Customer-facing value |
copyable | boolean | Whether the value is suitable for a copy action; absence means false |
Related guide: Mobile money transfer.