Description
...
Parameter | Data type | Description | |
| CompanyToken | Token | Token you got from 3G to operate this API | Mandatory |
Request | Text | verifyToken | Mandatory |
TransactionToken | Token | Transaction token as accepted from the URL redirected | Mandatory/Optional if CompanyRef is sent |
| CompanyRef | Text | Company reference number | Mandatory/Optional if TransactionToken is sent |
VerifyTransaction | Boolean (1/0) | By default, the system will verify the transaction and mark it as “website verified” in 3G systems. Send 1 to verify, 0 if you don't need. | Optional Default: 1 (True) |
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 |
...
Code | Explanation |
000 | Transaction Paid |
001 | Authorized |
002 | Transaction overpaid/underpaid |
| 003 | Pending Bank |
| 007 | Pending Split Payment (Part Payment Transactions not fully paid) |
801 | Request missing company token |
802 | Company token does not exist |
803 | No request or error in Request type name |
804 | Error in XML |
900 | Transaction not paid yet |
901 | Transaction declined |
| 902 | Data mismatch in one of the fields - field (explanation) |
903 | The transaction passed the Payment Time Limit |
904 | Transaction cancelled |
950 | Request missing transaction level mandatory fields – field (explanation) |
Codes in fraud alert:
Code | Explanation |
000 | Genuine transaction |
| 001 | Low Risk (Not checked) |
002 | Suspected Fraud Alert |
| 003 | Fraud alert cleared (Merchant marked as clear) |
| 004 | Suspect Fraud Alert |
| 005 | Fraud alert cleared (Low Risk (Checked)/ Genuine transaction) |
| 006 | Black - Fraudulent transaction |
Response example:
| Code Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?> <API3G> <Result>000</Result> <ResultExplanation>Transaction paid</ResultExplanation> <CustomerName >John Doe</CustomerName > <CustomerCredit>4432</CustomerCredit> <TransactionApproval>938204312</TransactionApproval> <TransactionCurrency>USD</TransactionCurrency> <TransactionAmount>950.00</TransactionAmount> <FraudAlert>000</FraudAlert> <FraudExplnation>No Fraud detected</FraudExplnation> <TransactionNetAmount>945</TransactionNetAmount> <TransactionSettlementDate>2013/12/31</TransactionSettlementDate> <TransactionRollingReserveAmount>5</TransactionRollingReserveAmount> <TransactionRollingReserveDate>2014/12/31</TransactionRollingReserveDate> <CustomerPhone>254123456789</CustomerPhone> <CustomerCountry>KE</CustomerCountry> <CustomerAddress>Stranfe blvd.</CustomerAddress> <CustomerCity>Nairobi</CustomerCity> <CustomerZip>AH1</CustomerZip> <MobilePaymentRequest>Sent</MobilePaymentRequest> <AccRef>ABC123REF</AccRef> </API3G> |
...