...
Verify the transaction’s details (get transaction’s details by transaction token or company reference)
...
Request
URL - {baseUrl}/API/v7/
These parameters will be sent in the request body. (POST method)
Parameter | Data Type | Description |
|
|---|---|---|---|
Request | Text | verifyToken | Mandatory |
CompanyToken | Text (Token - UUID) | Token you got from 3G to operate this API | Mandatory |
TransactionToken | Text (Token - UUID) | Transaction token as accepted from the URL redirected | Mandatory or Optional if CompanyRef is sent |
CompanyRef | Text | Company reference number | Mandatory or Optional if TransactionToken is sent |
VerifyTransaction | Boolean (1/0) Default - 1 | By default, the system will verify the transaction and mark it as “website verified” in 3G systems.This option should be set to false if you only want to verify the transaction was made, process the details and then you can send the verifyToken again with this parameter set to true to let 3G systems know that you have successfully processed the client.Send 1 to verify, 0 if you don't need. | Optional |
ACCref | Text | Internal accounting reference number. | Optional |
customerPhone | Text | Customer phone number can be updated | Optional / Mandatory if customerPhonePrefix sent |
customerPhonePrefix | Number | Customer phone prefix (without +) | Optional / Mandatory if customerPhone sent |
customerEmail | Text | Customer E-mail address can be updated | Optional |
The Flow
After the user will send the relevant fields, the fields will be validated
If all the fields will pass the validations, the transaction’s details will be responded back to the user as an XML response.
If one of the fields will fail the validation, an error will be responded accordingly as an XML response with the proper error message
...
Request (XML)
| Code Block |
|---|
<?xml version="1.0" encoding="utf-8"?>
<API3G>
<Request>verifyToken</Request>
<CompanyToken>{CompanyToken}</CompanyToken>
<TransactionToken>{transToken}</TransactionToken>
<CompanyRef>{CompanyRef}</CompanyRef>
<VerifyTransaction>{VerifyTransaction}</VerifyTransaction>
<ACCref>{ACCref}</ACCref>
<customerPhone>{customerPhone}</customerPhone>
<customerPhonePrefix>{customerPhonePrefix}</customerPhonePrefix>
<customerEmail>{customerEmail}</customerEmail>
</API3G>
|
Response (XML)
Success
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?>
<API3G>
<Result>000</Result>
<ResultExplanation>Transaction paid</ResultExplanation>
<TransactionCreatedDate>2019-12-25 12:45:49</TransactionCreatedDate>
<TransactionSettlementDate>2013/12/31</TransactionSettlementDate>
<TransactionRollingReserveAmount>5</TransactionRollingReserveAmount>
<TransactionRollingReserveDate>2014/12/31</TransactionRollingReserveDate>
<TransactionExpiryDate>2020-02-03 12:00:00</TransactionExpiryDate>
<TransactionPaymentDate>2019-12-25 12:47:30</TransactionPaymentDate>
<CustomerName>nathan nathan</CustomerName>
<CustomerPhone>254123456789</CustomerPhone>
<CustomerCountry>KE</CustomerCountry>
<CustomerAddress>Stranfe blvd.</CustomerAddress>
<CustomerCity>Nairobi</CustomerCity>
<CustomerZip>AH1</CustomerZip>
<CustomerEmail>nathan@aerocrs.com</CustomerEmail>
<CustomerPhone></CustomerPhone>
<PaymentType>Card</PaymentType>
<CardType>Mastercard</CardType>
<ApprovalNumber>4444444447</ApprovalNumber
<CardLastFour>8367</CardLastFour>
<TransactionAmount>1.00</TransactionAmount>
<TransactionCurrency>USD</TransactionCurrency>
<PartPaymentRef>0</PartPaymentRef>
<AllocationAmount>850</AllocationAmount>
<AllocationCode>demo1</AllocationCode>
<CompanyRef>dess</CompanyRef>
<CompanyAccRef>ABC123REF</CompanyAccRef>
<TransactionRef>8412B4A0</TransactionRef>
<ServiceDescription>Test Product</ServiceDescription>
<ServiceDate>2013/12/25 09:00</ServiceDate>
<TransactionFraudAlert>004</TransactionFraudAlert>
<TransactionFraudExplanation>Very high risk</TransactionFraudExplanation>
<TransactionFinalAmount>1.00</TransactionFinalAmount>
<TransactionFinalCurrency>USD</TransactionFinalCurrency>
<CardFirstSix>511221</CardFirstSix>
</API3G>
|
...