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
-
Request must be a made in POST action.
-
All the values must be URL encoded.
-
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: