Pay now

POST 
https://core-prod.malipopay.co.tz/api/v1/payment/now

Initiates a one-click pay-now payment using a pre-configured payload.

Request

application/json

Body

Bodyrequired

amountnumberrequired
Amount to charge in the smallest currency unit.
Example: 1500
referencestringrequired
Existing payment reference to charge against.
Example: ML26059
envstringrequired
Target environment (PROD or TEST).
Example: PROD

Example (auto)

{
  "amount": 1500,
  "reference": "ML26059",
  "env": "PROD"
}

Responses

201

Payment initiated successfully

application/json

Schema

Schema

successbooleanrequired
Example: true
codeintegerrequired
MALIPOPAY-specific status code (see error codes reference)
Example: 800
messagestringrequired
Example: Operation completed successfully
data object

Endpoint-specific payload

property name*any

Endpoint-specific payload

Example (auto)

{
  "success": true,
  "code": 800,
  "message": "Operation completed successfully",
  "data": {}
}

400

Bad request or validation error

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

401

Unauthorized

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

500

Internal server error

application/json

Schema

Schema

codeint32required
messagestringrequired

Example (auto)

{
  "code": 0,
  "message": "string"
}

Authorization: apiToken

name: apiTokentype: apiKeyin: headerdescription: Project API key. Get yours from the Malipopay dashboard under Settings → API Keys.

• curl
• python
• nodejs
• php
• java
• go

• CURL

curl -L 'https://core-prod.malipopay.co.tz/api/v1/payment/now' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'apiToken: <apiToken>' \
-d '{
  "amount": 1500,
  "reference": "ML26059",
  "env": "PROD"
}'

Request

Base URL

https://core-prod.malipopay.co.tz

Auth

apiToken

Body required

{
  "amount": 1500,
  "reference": "ML26059",
  "env": "PROD"
}

Response

Click the Send API Request button above and see the response here!