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 |
VeirfyTransaction | 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 | Genuine transaction |
001 | Fraud detected, action required, please consult Directpay Online system. |
002 | Fraud detected, transaction blocked |
| 003 | Fraud cleared (Merchant marked as clear) |
| 004 | Fraudulent |
| 005 | Fraud alert cleared |
| 006 | Black - Fraudulent |
Respond 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> |
...