malipopaycentralapi_UnifiedPaymentResponse

successboolean

Example: true

codeinteger

Malipopay status code. 1109 collection accepted, 1120 disbursement awaiting approval, 1111 disbursement accepted, 1117 approval executed.

Example: 1109

messagestring

Human-readable outcome.

Example: Collection request sent successfully

data object

The payment, plus available_channels on collection.

idstring

Malipopay id for the payment.

Example: 6890f1c2a4b19e3f2c7d5a10

referencestring

Malipopay reference. Use it to poll status and to match webhooks.

Example: ML008985

merchantAccountIdstring

Your merchant account name.

Example: Lockwood Technology

modestring

CHARGE for collections, PAYOUT for disbursements.

Example: CHARGE

statusstring

Current status. See the Payment Statuses guide.

Example: PROCESSING

amountinteger

Amount requested, in whole TZS.

Example: 50000

paidAmountinteger

Amount received so far. Below amount on a part payment.

Example: 0

transactionFeeinteger

Fee recorded against this transaction, in TZS.

Example: 1250

amountTypestring

Amount rule the payment was created with.

Example: FULL

descriptionstring

Description you supplied.

Example: Payment for Order #001

currencystring

ISO currency code.

Example: TZS

linkstring

Shareable link for this payment.

Example: https://app.malipopay.co.tz/ref?ML008985

customer object

phoneNumberstring

Normalised MSISDN.

Example: 255712345678

firstnamestring

Resolved first name, when the channel returns one.

Example: JOHN

lastnamestring

Resolved last name.

Example: HAULE

mnostring

Resolved network.

Example: Vodacom

feeAmountinteger

What Malipopay charged on this collection, in TZS. Present only on collections posted under the upfront fee model - a payment that predates it has no per-payment fee to report, which is a different statement from having been charged nothing.

Example: 1250

feePercentnumber

Rate applied to produce feeAmount.

Example: 2.5

netAmountinteger

What was credited to your wallet after the fee.

Example: 48750

failureboolean

Present only when a payout failed its balance precheck.

failureReasonstring

Why the payment failed. Present only on failures.

Example: Insufficient balance

createdAtstring

ISO 8601 creation timestamp.

Example: 2026-08-18T08:15:32.000Z

updatedAtstring

ISO 8601 last-update timestamp.

Example: 2026-08-18T08:15:32.000Z

malipopaycentralapi_UnifiedPaymentResponse

{
  "success": true,
  "code": 1109,
  "message": "Collection request sent successfully",
  "data": {
    "id": "6890f1c2a4b19e3f2c7d5a10",
    "reference": "ML008985",
    "merchantAccountId": "Lockwood Technology",
    "mode": "CHARGE",
    "status": "PROCESSING",
    "amount": 50000,
    "paidAmount": 0,
    "transactionFee": 1250,
    "amountType": "FULL",
    "description": "Payment for Order #001",
    "currency": "TZS",
    "link": "https://app.malipopay.co.tz/ref?ML008985",
    "customer": {
      "phoneNumber": "255712345678",
      "firstname": "JOHN",
      "lastname": "HAULE",
      "mno": "Vodacom"
    },
    "feeAmount": 1250,
    "feePercent": 2.5,
    "netAmount": 48750,
    "failure": true,
    "failureReason": "Insufficient balance",
    "createdAt": "2026-08-18T08:15:32.000Z",
    "updatedAt": "2026-08-18T08:15:32.000Z"
  }
}