v1

latestOpenAPI 3.0.3Proprietary2026-07-2441103204.8 KB
Status

Query payment status

Query the status of a payment.

For more information, see the documentation.

get/api/payments/{paymentId}

Path parameters

paymentIdstring required

Payment ID. Returned when creating a new payment.

Response

OK.

Example response

{
  "payment": {
    "id": "b95d6888-591b-4538-b508-6102cf1259c9",
    "payment": {
      "linkId": "G56F5_ll",
      "linkUrl": "https://l.ppay.io/af6c33cce7fabefb",
      "amount": 123.45,
      "status": "completed",
      "currency": "ZAR",
      "merchantInvoiceId": "INV90001",
      "entityId": "8ac7a4ca77a64c9c0177af52972c13bd",
      "notes": "Please pay this at your earliest convenience.",
      "expiryTime": "2021-10-27T12:45:27Z",
      "batchId": "421e1e63-ddd5-46ec-8812-74eda861259b"
    },
    "source": "API",
    "createdAt": "2021-10-27T12:35:27Z",
    "updatedAt": "2021-10-27T12:45:43Z",
    "customer": {
      "email": "name@example.com",
      "fax": "2919392022",
      "givenName": "Jane",
      "surname": "Doe",
      "mobile": "27610107822",
      "phone": "27210030000",
      "ip": "0.0.0.0",
      "merchantCustomerLanguage": "EN",
      "status": "NEW",
      "merchantCustomerId": "sxxopjqy",
      "taxId": "4550045030303",
      "taxType": "tax type",
      "birthDate": "1996-08-07",
      "browser": {
        "acceptHeader": "application/json",
        "language": "EN",
        "screenHeight": "1080",
        "screenWidth": "1920",
        "timezone": "30",
        "userAgent": "Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0",
        "javaEnabled": "false",
        "javascriptEnabled": "true",
        "screenColorDepth": "24",
        "challengeWindow": "01"
      }
    },
    "options": {
      "emailCc": "ccexample@example.com",
      "emailBcc": "bccexample@example.com",
      "notificationUrl": "https://example.com/example-webhook/"
    },
    "checkout": {
      "defaultPaymentMethod": "CARD",
      "paymentType": "DB",
      "registrationId": "8ac7a4a180223d220180227b2cf649f0",
      "checkoutId": "d6a8014a622a442aad90c72320419b2b",
      "transactionUniqueId": "450bf3b1-c479-4b30-99ca-5b598a889b8f",
      "resultCode": "000.100.110",
      "paymentBrand": "VISA"
    }
  },
  "audit": [
    {
      "oldStatus": "initiated",
      "newStatus": "processing",
      "timestamp": "2021-10-27T12:45:43Z"
    }
  ]
}