Description
The verifyToken request can be initiated at any time, and it is mandatory to verify the token when the customer will return to the application, not verifying the token within 30 minutes of transaction completed of payment, will generate an alert e-mail to the provider announcing that there was no verification process.
URL: https://secure.3gdirectpay.com/API/v6/
Request
The method will respond with the result of your request
...
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 Block | ||||
|---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?> <API3G> <Result>000</Result> <ResultExplanation>Transaction paid<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> <TransactionCreatedDate>2023/08/25 09:27:08</TransactionCreatedDate> <TransactionSettlementDate>2023/09/04</TransactionSettlementDate> <TransactionRollingReserveAmount>0.00</TransactionRollingReserveAmount> <TransactionRollingReserveDate>2023/08/25</TransactionRollingReserveDate> <TransactionExpiryDate>2023/08/25 14:27:08</TransactionExpiryDate> <TransactionPaymentDate>2023/08/25 09:42:33</TransactionPaymentDate> <CustomerName>Cons Connie </CustomerName> <CustomerPhone>706527126</CustomerPhone> <CustomerCountry>Kenya</CustomerCountry> <CustomerAddress></CustomerAddress> <CustomerCity>Mbsa</CustomerCity> <CustomerZip></CustomerZip> <CustomerEmail>koyoreads@gmail.com</CustomerEmail> <PaymentType></PaymentType> <CardType>Mobile</CardType> <ApprovalNumber>RHP2ZIGD5U</ApprovalNumber> <CardLastFour></CardLastFour> <CardFirstSix></CardFirstSix> <TransactionAmount>1.0000</TransactionAmount> <TransactionCurrency>KES</TransactionCurrency> <PartPaymentRef>0</PartPaymentRef> <AllocationAmount></AllocationAmount> <AllocationCode></AllocationCode> <CompanyRef></CompanyRef> <CompanyAccRef></CompanyAccRef> <TransactionRef>R49500190</TransactionRef> <ServiceDescription>Sstream.co.ke Order for Stream tech test</ServiceDescription> <ServiceDate></ServiceDate> <TransactionFraudAlert>001</TransactionFraudAlert> <TransactionFraudExplanation>Low Risk (Not checked)</TransactionFraudExplanation> <TransactionFinalAmount>1.0000</TransactionFinalAmount> <TransactionFinalCurrency>KES</TransactionFinalCurrency> </API3G> |