Versions Compared

Old Version 23

changes.mady.by.user Alex Mathenge

Saved on

compared with

New Version Current

changes.mady.by.user Lee Collin Kiama

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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://secure1secure.sandbox3gdirectpay.directpay.onlinecom/API/v6/


Request

The method will respond with the result of your request

...

Parameter

Data type

Description


CompanyTokenTokenToken you got from 3G to operate this APIMandatory

 Request

 Text

 verifyToken

Mandatory

TransactionToken

Token

Transaction token as accepted from the URL redirected

Mandatory/Optional if CompanyRef is sent

CompanyRefTextCompany 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.
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

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
languagexml
titleresponse example
<?xml version="1.0" encoding="utf-8"?>
<API3G>
    <Result>000</Result>
 	<ResultExplanation>Transaction paid<Paid</ResultExplanation>
	<CustomerName>Cons <CustomerNameConnie >John Doe<</CustomerName >
 <CustomerCredit>4432<CustomerName>
	<CustomerCredit></CustomerCredit>
 <TransactionApproval>938204312<	<CustomerCreditType>Mobile</CustomerCreditType>
	<TransactionApproval>RHP2ZIGD5U</TransactionApproval>
 <TransactionCurrency>USD<	<TransactionCurrency>KES</TransactionCurrency>
 <TransactionAmount>950	<TransactionAmount>1.00</TransactionAmount>
 <FraudAlert>000<	<FraudAlert>001</FraudAlert>
	<FraudExplnation>Low <FraudExplnation>NoRisk Fraud detected<(Not checked)</FraudExplnation>
 <TransactionNetAmount>945<	<TransactionNetAmount>0.99</TransactionNetAmount>
 <TransactionSettlementDate>2013	<TransactionSettlementDate>2023/1209/31<04</TransactionSettlementDate>
 <TransactionRollingReserveAmount>5<	<TransactionRollingReserveAmount>0.00</TransactionRollingReserveAmount>
 <TransactionRollingReserveDate>2014	<TransactionRollingReserveDate>2023/1208/31<25</TransactionRollingReserveDate>
 <CustomerPhone>254123456789<	<CustomerPhone>706527126</CustomerPhone>
 <CustomerCountry>KE<	<CustomerCountry>Kenya</CustomerCountry>
 <CustomerAddress>Stranfe blvd.<	<CustomerAddress></CustomerAddress>
 <CustomerCity>Nairobi<	<CustomerCity>Mbsa</CustomerCity>
 <CustomerZip>AH1<	<CustomerZip></CustomerZip>
	<MobilePaymentRequest>Not <MobilePaymentRequest>Sent<sent</MobilePaymentRequest>
 <AccRef>ABC123REF</AccRef>	<AccRef></AccRef>
	<TransactionFinalCurrency>KES</TransactionFinalCurrency>
	<TransactionFinalAmount>1.00</TransactionFinalAmount>
</API3G>