KOROMA
  1. Home
  2. API Docs

API Documentation

transact


transact is a simple transactional interface catering for

  • payment authorization
  • authorization reversals
  • payment captures
    •
One simple transactional interface and similarly, a single response payload for all transactions.
There are three (3) mandatory fields, the remaining are per transaction fields. Payments accepts card and token.

Endpoint: https://koroma.co.za/transact

Payload:
  1. channelid - Identifier assigned to the channel at successful authentication
  2. clientrefcode - A uniquely generated code for the transaction
  3. amount - Order amount, decimals are separated by "."
  4. cardnumber - Customer payment card number also known as Primary Account Number (PAN)
  5. cardtoken - Transacting card 16-digits number
  6. cardmonth - Two-digit month in which the payment card expires (forat 01-12)
  7. cardyear - Four-digit year in which the payment card expires (format CCYY)
  8. cardcvv - Card Verification Number
  9. reversalurl - The reversal url received in the payment authorization response<
  10. reversalreason - Reason for the authorization reversal
  11. captureurl - The capture url received in the payment authorization response
  12. capturecurrency - Currency used for the order. Use the three-character ISO Standard Currency Codes
Test/Example:
  1. Make a payment authorization transaction
  2. Make an authorization reversal transaction
  3. Make another payment authorization transaction
  4. Make a payment capture transaction

Back to top