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 |
...
Parameter | Data type | Description |
Result | 3 digits code | A code will be sent with the result of the request |
ResultExplanation | Text | Free text of the result |
CustomerName | Text | Customer name as filled in the form of 3GDirectpay payment page.Will be sent if transaction paid/failed |
CustomerCredit | Text | 4 digits of credit cardWill be sent if transaction paid/failed |
CustomerCreditType | Text | Credit card type |
TransactionApproval | Text | Transaction approval numberWill be sent if transaction paid/failed |
TransactionCurrency | Text | Currency final payment (the customer can convert the payment)Will be sent if transaction paid/failed |
TransactionAmount | Money | Paid amount Will be sent if transaction paid/failed |
FraudAlert | 3 digits code | According to fraud codes table |
FraudExplnation | Text | Free text of fraud analysis |
TransactionNetAmount | Amount | NET transaction amount |
TransactionSettlementDate | Date | Date of transaction settlement |
TransactionRollingReserveAmount | Amount | Transaction rolling reserve amount |
TransactionRollingReserveDate | Date | Date of rolling reserve release |
CustomerPhone | Text | Customer phone number |
CustomerCountry | Text | Customer country |
CustomerAddress | Text | Customer address |
CustomerCity | Text | Customer city |
CustomerZip | Text | Customer zip code |
TransactionRollingReserveDate | Date | Date of rolling reserve release |
MobilePaymentRequest | Text | Mobile payment request status |
AccRef | Text | Internal accounting reference number |
Codes in
...
response:
Code | Explanation |
000 | Transaction Paid |
001 | Authorized |
002 | Transaction overpaid/underpaid |
| 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) |
...
Code | Explanation |
000 | Genuine transaction |
002 | Suspected Fraud Alert |
| 003 | Fraud alert cleared (Merchant marked as clear) |
| 004 | Suspect Fraud Alert |
| 005 | Fraud alert cleared (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> |
...