Description
The chargeTokenCreditCard request will charge a transaction created by createToken
URL: https://secure.3gdirectpay.com/API/v6/
Response
The method will response with the result of your request
Variables to send:
Parameter | Data type | Description | |
Request | Text | chargeTokenCreditCard | Mandatory |
CompanyToken | Token | Token you got from 3G to operate this API | Mandatory |
TransactionToken | Token | Transaction token as accepted from the createToken. | Mandatory |
CreditCardNumber | Number | Credit card number | Mandatory |
CreditCardExpiry | MMYY | Month and year of expiry of credit card | Mandatory |
CreditCardCVV | Number | 3-4 digits of CVV | Mandatory |
CardHolderName | Text | Card holder name | Mandatory |
| ChargeType | Text | Charge type of the card | Optional |
| ThreeD | Data | Data for 3D process | Optional |
ThreeD data to send (Data for 3D process (depend by terminal (MPGS3D2, MPGS3D2Airlines and PG3D2):
Parameter | Data type | Description |
| Enrolled | Text | 3D2 param, mandatory for all terminal types |
| Eci | Text | 3D2 param, mandatory for all terminal types |
| Cavv | Text | 3D2 param, mandatory for all terminal types |
| ThreedDSTransId | Text | 3D2 param, mandatory for PG3D |
| ThreedMessageVersion | Text | 3D2 param, mandatory for all terminal types |
| TransactionStatus | Text | 3D2 param, mandatory for all terminal types |
| ThreeDStatus | Number | 3D2 param, mandatory for all terminal types |
| ThreedACSIssuerCode | Number | 3D2 param, mandatory for PG3D only |
Request example:
<?xml version="1.0" encoding="utf-8"?>
<API3G>
<CompanyToken>57466282-EBD7-4ED5-B699-8659330A6996</CompanyToken>
<Request>chargeTokenCreditCard</Request>
<TransactionToken>72983CAC-5DB1-4C7F-BD88-352066B71592</TransactionToken>
<CreditCardNumber>123412341234</CreditCardNumber>
<CreditCardExpiry>1214</CreditCardExpiry>
<CreditCardCVV>333</CreditCardCVV>
<CardHolderName>John Doe</CardHolderName>
<ChargeType></ChargeType>
<ThreeD>
<Enrolled>Y</Enrolled>
<Eci>05</Eci>
<ThreedDSTransId>41c98d57-8262-438f-b15b-143128440f5d</ThreedDSTransId>
<Cavv>mHyn+7YFi1EUAREAAAAvNUe6Hv8=</Cavv>
<ThreedACSIssuerCode>02</ThreedACSIssuerCode>
<ThreedMessageVersion>2.1.0</ThreedMessageVersion>
<TransactionStatus>Y</TransactionStatus>
</ThreeD>
</API3G>
Respond:
The server will respond for the chargeTokenCreditCard request according to the following results:
Parameter | Data type | Description |
Result | 3/4 digits code | A code will be sent with the result of the request |
ResultExplanation | Text | Free text of the result |
Respond codes:
Code | Explanation |
000 | Transaction charged |
| 200 | Transaction already paid |
801 | Request missing company token |
802 | Wrong CompanyToken |
803 | No request or error in Request type name |
804 | Error in XML |
902 | Data mismatch in one of the fields – fieldname |
950 | Request missing mandatory fields – fieldname |
| 999 | Transaction Declined - Explanation |
Respond example:
<?xml version="1.0" encoding="utf-8"?> <API3G> <Result>000</Result> <ResultExplanation>Transaction charged </ResultExplanation> </API3G>