KOROMA
  1. Home
  2. API Docs

API Documentation

payments


payments is a card payment authorization request from an authenticated service.
The platform will handle all the gateway security requirements of the message in initiating a payment authorization request.

The interface accepts requests for either a tokenized and non-tokenized card. For a tokenized card, simply pass the available field in the same payload.
The platform will internally handle the difference and fulfil the payment authorization request.

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

Payload:

  1. serviceid - the service/application serviceid received at successful authentication
  2. paymentid - the payment transaction identifier
  3. cardnumber - the transacting card 16-digits number
  4. cardmonth - the card expiry month in the format 1-12
  5. cardyear - the card expiry year in the format CCYY
  6. cardcvv - the card 3 or 4-digits cvv number
  7. cardamount - the transaction amount, decimals are separated by "."
Test/Example:
  1. Initiate a payment authorization with the card details
  2. Receive the payment gateway response in a flat structure
 https://koroma.co.za/transact
	
JSON Request
{
    "serviceid": "dd8bfeb238ea593b2fd2ede8ce1103717d9f0601762230223fddb16b...",
    "paymentid": "5218fbee081b1cdf65856473325809b7e4e2d4e6",
    "cardnumber": "5610591081018250",
    "cardmonth": "12",
    "cardyear": "2028",
    "cardcvv": "937",
    "cardamount": "1459"
}


JSON Response
{
    "serviceid": "dd8bfeb238ea593b2fd2ede8ce1103717d9f0601762230223fddb16b...",
    "clientReferenceInformationCode": "5218fbee081b1cdf65856473325809b7e4e2d4e6",
    "id": "7409956900346927404806",
    "reconciliationId": "X2S3R7CZS4BF",
    "paymentStatus": "AUTHORIZED_PENDING_REVIEW",
    "SubmitTimeUtc": "2025-03-03T09:54:50Z",
    "errorInformationReason": "DECISION_PROFILE_REVIEW",
    "errorInformationMessage": "The order is marked for review by Decision Manager",
    "errorInformationField": "",
    "errorDetailsReason": "",
    "linksAuthReversalMethod": "POST",
    "linksAuthReversalHref": "/pts/v2/payments/7409956900346927404806/reversals",
    "linksSelfMethod": "GET",
    "linksSelfHref": "/pts/v2/payments/7409956900346927404806",
    "linksCaptureMethod": "POST",
    "linksCaptureHref": "/pts/v2/payments/7409956900346927404806/captures",
    "orderInformationAuthorizedAmount": "1459.00",
    "orderInformationCurrency": "USD",
    "paymentAccountInformationCardType": "",
    "paymentInformationScheme": "MAESTRO DEBIT",
    "paymentInformationBin": "561059",
    "paymentInformationAccountType": "",
    "paymentInformationIssuer": "",
    "paymentInformationBinCountry": "AU",
    "processorInformationMerchantNumber": "",
    "processorInformationApprovalCode": "831000",
    "processorInformationResponseCode": "00",
    "processorInformationNetworkTransactionId": "0602MCC603474",
    "processorInformationTransactionId": "0602MCC603474",
    "processorInformationAVSCode": "Y",
    "processorInformationAVSCodeRaw": "Y",
    "pointOfSaleTerminalId": "",
    "issuerInformationResponseRaw": "0110322000000E1000020000000000001459000303095450088852583253335237435A53344246383331303030303000015901130048313441303630324D4343363033343734202020202020202020202020202020202020202030303030303030303030303000103232415050524F56414C00494D433031311C3032301C3033311C3034301C3035351C3036301C3037531C3038301C3039351C3130311C3131311C313230",
    "consumerAuthInfoAccessToken": "Axj/7wSTkbHPPTs1MlcGABsZYZU2dJvDtU2kKMnvyRssa4EnvyRssa+kEo57E8ZeDSTL0YwczU4NJORsc89OzUyVwYAAhzRG",
    "riskInformationLocalTime": "1:54:50",
    "riskInformationScoreResult": "48",
    "riskInformationScoreFactorCodes": "",
    "riskInformationScoreModelUsed": "default",
    "riskInformationAddress": "",
    "riskInformationGlobalVelocity": "",
    "riskInformationSuspicious": "",
    "riskInformationIdentityChange": "",
    "riskInformationProfileName": "Standard mid-market profile",
    "riskInformationProfileEarlyDecision": "REVIEW",
    "riskInformationProfileDestinationQueue": "Review Queue",
    "riskInformationProfileSelectorRule": "Default Active Profile",
    "riskInformationRulesDecision": "",
    "riskInformationRulesName": "",
    "riskInformationRulesExecutionTiming": ""
}
Back to top