Payment Portal API Documentation

APIs for initiating transactions and checking transaction status.

1. Endpoint: Initiate Transaction

This endpoint allows you to initiate a payment transaction.

HTTP Method

POST

URL

https://paynow.rockandrobot.com/initiate_transaction

Request Body

{
    "integration_id": "17146",
    "integration_key": "5d4305aa-a39b-4241-9f9c-77eb7e09c149",
    "phone_number": "0772222222",
    "email_address": "satorugojo04@yahoo.com",
    "amount": "29",
    "payer_id": "Satoru Gojo",
    "payment_currency": "USD",
    "payment_method": "ecocash",
    "description": "Bilem"
}

Response Format

{
    "success": true,
    "message": "Transaction initialized successfully.",
    "poll_url": "https://www.paynow.co.zw/Interface/CheckPayment/?guid=e9ef85c6-17a4-4958-a7fe-afc94ed355b6",
    "reference": "ref_67925c1f349f30.55953929"
}

Example cURL Request

curl -X POST https://paynow.rockandrobot.com/initiate_transaction \
-H "Content-Type: application/json" \
-d '{
    "integration_id": "15146",
    "integration_key": "9d4305aa-a39b-4241-9f9c-77eb7e08c149",
    "phone_number": "0772222222",
    "email_address": "satorugojo04@yahoo.com",
    "amount": "2",
    "payer_id": "Satoru Gojo",
    "payment_currency": "USD",
    "payment_method": "ecocash",
    "description": "Dumblings"
}'

2. Endpoint: Check Transaction Status

This endpoint allows you to check the status of a payment transaction.

HTTP Method

GET

URL

https://paynow.rockandrobot.com/check_transaction_status

Request Parameters

integration_id=19146
integration_key=5d4305aa-a39b-4241-9f9c-77eb7e08c149
reference=ref_67925c1f349f30.55953929

Response Format

{
    "success": true,
    "message": "Response Obtained",
    "status": "Paid",
    "reference": "ref_67925c1f349f30.55953929"
}

Example cURL Request

curl -X GET "https://paynow.rockandrobot.com/check_transaction_status?integration_id=19146&integration_key=5d4305aa-a39b-4241-9f9c-77eb7e08c149&reference=ref_67925c1f349f30.55953929"