מרכז הידע / ממשקים - ישן לפני שנת 2020

Charge (or Refund) token api - EN (Step 3)

Charge (or Refund) token api - EN (step 3)

JSON:

The docs on the function - שלב 3 - חיוב של אסימון (Do Transaction)

The function - Do Transaction

Name to Value address: 

https://secure.cardcom.solutions/interface/ChargeToken.aspx

  1. Request must be a made in POST action.

  2. All the values must be URL encoded.

  3. The response is in Name to Value format for example: ResponseCode=4&Description=NoPemition&LowProfileCode=601.

Key
Red parameter - must
bold parameter - recomended
not red or bold - optional

Number

parameter

Description

Example value

 1

terminalnumber

internal terminal number (not shava)

1000

 2

username

Username

TestUser

 3

codepage

this parameters shows the unicode type

65001

 4

TokenToCharge.Token

The chargeable token

AA-BB-CC

 5

TokenToCharge.Salt

Salt token as transferred during creation (not used)

1234

 6

TokenToCharge.CardValidityMonth

MM card validity

03

 7

TokenToCharge.CardValidityYear

YY card validity.

19

 8

TokenToCharge.SumToBill

Billing amount

4500.50

 9

TokenToCharge.ApprovalNumber

If the terminal has a CVV, it is not possible to charge a transaction token without passing this parameter.
2. Confirmation number received when performing J5 to the card
A confirmation number should only be used once.
3. If the console does not have a CVV, it is not possible to pass this parameter.
4. Customers who are removed with IMAPAY should not pass this parameter. If the money is transferred, it will be received on the 15th of next month.

0

 10

TokenToCharge.IdentityNumber

ID. the owner of the card

040617644

 11

TokenToCharge.CoinID

Billable currency

NIS 1
2 - dollars
Otherwise: A 
list of billing currency codes

 

TokenToCharge.APILevel

API version, last version 10

10

 12

TokenToCharge.SumInStars

Amount for star billing

0

 13

TokenToCharge.NumOfPayments

Multiple billing payments

5

 14

TokenToCharge.RefundInsteadOfCharge

Whether to credit a token instead of a charge

Fasle - Charge Token
True - token refund

 15

TokenToCharge.UserPassword

If credits are issued with a token refund , the API password must be passed to that user's credits

aSD34SDF-1asd

 16

TokenToCharge.ExtendedParameters

Ignore

not in use

 17

TokenToCharge.CardOwnerName

The name of the card holder to display in reports

 

 18

TokenToCharge.SapakMutav

Customer number in the work of a beneficiary rabbi.

1234

 19

TokenToCharge.TokenCompanyUserName

Optional - Which company has the positive charge.

 

 20

TokenToCharge.TokenCompanyPassword

Optional - Which company has the positive charge.

 

 21

TokenToCharge.FirstPaymentSumAgorot

Optional - First payment amount in heart payments ! Amounts are in agorot - see note at end of table

 

 22

TokenToCharge.ConstPaymentAgorot

Optional - the amount of other payments to the heart! Amounts are in agorot - see note at end of table

 

 23

TokenToCharge.MTI 

Request cancellation of credit-line / "on-hold" charge( Also needed - Approvalnumber param )

 420 - Fixed value

 23

 

TokenToCharge.JParameter

A token exists in the system and want to perform a frame perception again
This parameter can be passed with a value of 5 (optional)

Frame perception
Test card - 2

 24

 TokenToCharge.IsAutoRecurringPayment

 Direct debit only in EMV terminal The parameter must be passed as true (not mandatory) - the transaction will be marked as direct debit and not as regular debit. Credit companies require this parameter to be transferred - in a direct debit terminal.
Required if you want to get a file overwritten from the credit card company. Update file is overwritten from the credit card company

 true

 24

TokenToCharge.UniqAsmachta

Unique Transaction ID - Preferred

The transaction ID must be transferred to your system. If we receive the same system identifier, we return a double transaction. And will not charge the transaction

25 characters long.

To avoid T/O when using this parameter, send requests contatning UniqAsmachta - 
in sequence, not in parallel.

 

TokenToCharge.UniqAsmachtaReturnOriginal

false

Should I return the original answer in a double transaction instead of a double transaction error?

 

 

Response Parameters Table:

Number

parameter

Description

Example value

 1

ResponseCode

Response Code

0 = correct
, other incorrect

 2

Description

Description of the answer,
If different than 0, you must register and alert the administrator

OK

 3

ApprovalNumber

Approval number received from the credit companies

0014215

 4

InternalDealNumber

Unique Code of Transaction in Gold Certificate System - This code must be kept for future inquiries The field size is BIGINT (64 bit length)

1234567

 5

 InvoiceResponse.ResponseCode

 Invoice answer code, there is a situation that the charge is correct but there is a problem with the invoice. A gold certification system gives priority to billing.

0

 6

 InvoiceResponse.Description

 Description of Invoice Answer Answer

OK

 7

 InvoiceResponse.InvoiceNumber

Invoice number, the invoice type must also be saved for identification

332 

 8

 InvoiceResponse.InvoiceType

 Invoice type, the invoice type must be saved together with the invoice number for identification

1- Receipt Tax Invoice
2- Credit Invoice (Receipt of Nonprofit Credit)

 

Codes For Example:

קבצים מצורפים

האם המאמר הזה עזר לך?