Versions Compared

Key

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

...

The chargeTokenCreditCard request will charge a transaction created by createToken

URL: https://secure1secure.sandbox3gdirectpay.directpay.onlinecom/API/v6/ 


Response

The method will response with the result of your request 


Variables to send:

Optional

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

MandatoryCardHolderID

ChargeTypeText

Card holder ID / Passport

Mandatory

CardHolderIP

IP address

Card holder IP

Optional

CardHolderLAT

Number

Card holder LAT in decimals

Optional

CardHolderLONG

Number

Card holder LONG in decimals

Charge type of the cardOptional
ThreeDDataData for 3D process Optional

ThreeD data to send (Data for 3D process (depend by terminal (MPGS3D2, MPGS3D2Airlines and PG3D2):


Parameter

Data type

Description

EnrolledText3D2 param, mandatory for all terminal types
EciText3D2 param, mandatory for all terminal types
CavvText3D2 param, mandatory for all terminal types
ThreedDSTransIdText3D2 param, mandatory for PG3D
ThreedMessageVersionText3D2 param, mandatory for all terminal types
TransactionStatusText3D2 param, mandatory for all terminal types
ThreeDStatusNumber3D2 param, mandatory for all terminal types
ThreedACSIssuerCodeNumber3D2 param, mandatory for PG3D only
AuthenticationTypeNumber3D2 Param, Mandatory for NI3D terminal types
ThreedServerTransIdText3D2 Param, Mandatory for NI3D terminal types

Request example:


Code Block
languagexml
titlerequest 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>
  <CardHolderID>29328832A94</CardHolderID>
  <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:

 


Declined + Reason of declined

Code

Explanation

000

Transaction charged

701

200Transaction already paid

801

Request missing company token

802Company

token does not existWrong CompanyToken

803

No request or error in Request type name

804

Error in XML

901

Request missing mandatory fields – fieldname

902

Data mismatch in one of the fields – fieldname

903

No such transaction

904

No country defined for transaction and it is mandatory

905

Transaction already charged.

950

Request missing transaction level mandatory fields

...

– fieldname

999Transaction Declined - Explanation


Respond example:


Code Block
languagexml
titleresponse example
<?xml version="1.0" encoding="utf-8"?>
<API3G>
 <Result>000</Result>
 <ResultExplanation>Transaction charged </ResultExplanation>
</API3G>

 

 

...