Request Fields

Field Description MaxLength Required 1
CompanyNum Your company number - ####### 7 Yes
TransType 2 0 = SALE Transaction 2 Yes
CardNum The card holder card number 20 Yes 3
CVV2 CVC verification number 5 Optional
ExpMonth Expiration month (MM) 2 Yes 3
ExpYear Expiration year (YYYY) 4 Yes 3
Member Cardholder name as it appears on the card 50 Yes 3
TypeCredit 2 1 = Debit 1 Yes
Payments Number of installments, 1 for regular transaction 2 Yes
Amount Amount to be charged, e.g. 199.95 10 Yes
Currency Supported Currencies can be found Here, in Server to Server mode you must send the Currency ID. 1 Yes
Email Cardholder email address 50 Mandatory
PersonalNum Cardholder Driver ID or social security number 20 Optional
DateOfBirth Date of birth of card holder format should be yyyyMMdd 8 Optional
PhoneNumber Cardholder phone number 20 Optional
ClientIP IP address of the client making the purchase 15 Mandatory
BillingAddress1 1st Address line 100 Optional
BillingAddress2 2nd Address line 100 Optional
BillingCity City name 60 Optional
BillingZipCode Zip Code number 15 Optional
BillingState State - 2 character iso format
Required only when BillingCountry is US/CA. 		5 Optional
BillingCountry Country - 2 character iso format 5 Optional
ConfirmationNum Confirmation number 7 Optional
Order Unique Text used to defer one transaction from another 100 Optional
PLID Platform user ID - A unique identifier for the user on the platform 100 Optional
Comment Optional text used mainly to describe the transaction 500 Optional
TrmCode When activated and applied in merchant config, this parameter selects the exact terminal to use 4 Optional
RRL (Risk Rule Level) by map listed below: 0=Bronze/1=Silver/2=Gold/3=Platinum 4 Optional
RetURL 3D secure only, In cases where 553 is returned.
the client should be redirected to bank's site.
when the interaction with bank is done, the client is redirected to this URL. 		255 Optional
notification_url The callback URL you wish our servers to update at the end of each transaction, this can passed either via the MCP or via this field. 255 Optional
hashtype Will determine the format of the response signature, both format will be sent in the Signature parameter of the response, not sending any value in the parameter or not sending it at all will leave the Sigature format in its default state.
Send the value of 1 for the new format of the response signature:

urlencode(base64( hash('sha256', trans_id + trans_refNum+ replyCode + trans_amount + trans_currency + merchanthash))) 		1 Optional
CustomRouting This param allows you to send the custom route id as provided to you by support - this will give you control to which routing configuration to send the transaction - please note that if no such route is configured you will get a 503 - Decline indicating your have no configuration matching this transaction 10 Optional
SF_IsExternal3D Indicates that the merchant has already completed the entire 3DS flow on their side. 1 Yes
SF_ThreeDS_AuthenticationValue CAVV / AAV / TAVV returned by the merchant’s 3DS authentication. kANBCCDDYJYjadADpka8KoQBXMqS Yes
SF_ThreeDS_DirectoryServerTransId dsTransID from 3DS response. 5340af8a-5505-4bf6-abcd-123412341234 Yes
SF_ThreeDS_ECI ECI indicator. Must match scheme rules. 01, 02, 05, 06 Optional
SF_ThreeDS_Version Three-D Secure version used by the merchant or wallet. 2.1.0 / 2.2.0 Optional
Signature Signature for verifying the authenticity of the request parameters.
Field values to use: CompanyNum + TransType + TypeCredit + Amount + Currency + CardNum + RefTransID + PersonalHashKey
Refer to BASIC INFO SIGNATURE for detailed explanation. 		50 Mandatory

Code example

Code Example
var Siganture = CryptoJS.SHA256(CompanyNum + 0 + TypeCredit + Amount + Currency + CardNum + PersonalHashKey);
var Base64Siganture = Siganture.toString(CryptoJS.enc.Base64);
var hash = encodeURIComponent(Base64Siganture);

var src = ""https://process.coriunder.cloud/member/remote_charge.asp?" +
"CompanyNum=" + CompanyNum +
"&TransType=0" +
"&Brand=" + Brand +
"&CardNum=" + CardNum +
"&ExpMonth=" + ExpMonth +
"&ExpYear=" + ExpYear +
"&TypeCredit=" + TypeCredit +
"&Payments=1" +
"&Amount=" + Amount +
"&Member=" + encodeURIComponent(Member) +
"&Currency=" + Currency +
"&CVV2=" + CVV2 +
"&Email=" + encodeURIComponent(Email) +
"&PhoneNumber=" + encodeURIComponent(PhoneNumber) +
"&BillingAddress1=" + encodeURIComponent(BillingAddress1) +
"&BillingAddress2=" + encodeURIComponent(BillingAddress2) +
"&BillingCity=" + encodeURIComponent(BillingCity) +
"&BillingZipCode=" + BillingZipCode +
"&BillingCountry=" + BillingCountry +
"&StoreCc=" + StoreCc +
"&Order=" + Order +
"&ClientIP=" + ClientIP +
"&AutoWalletRegistration=" + AutoWalletRegistration +
"&RetURL=" + encodeURIComponent(RetURL) +
"¬ification_url=" + encodeURIComponent(notification_url) +
"&SF_IsExternal3D=" + SF_IsExternal3D +
"&SF_ThreeDS_AuthenticationValue=" + encodeURIComponent(SF_ThreeDS_AuthenticationValue) +
"&SF_ThreeDS_DirectoryServerTransId=" + encodeURIComponent(SF_ThreeDS_DirectoryServerTransId) +
"&SF_ThreeDS_ECI=" + SF_ThreeDS_ECI +
"&SF_ThreeDS_Version=" + SF_ThreeDS_Version +
"&Signature=" + encodeURIComponent(hash);

Request example

Request
https://process.coriunder.cloud/member/remote_charge.asp?
CompanyNum=8057557&
TransType=0&
CardNum=5520330000002205&
ExpMonth=10&
ExpYear=2028&
Member=John%20Dow&
TypeCredit=1&
Payments=1&
Amount=100&
Currency=USD&
CVV2=693&
Email=John@dow.com&
PhoneNumber=+3534535345&
Order=154875&
ClientIP=188.122.3.84&
notification_url=https://webhook.site/0e7df831-a62b-48a2-9153-2e6495d14151&
BillingAddress1=7%20old%20street&
BillingCity=London&BillingZipCode=WE432342&
BillingCountry=GB&
RetURL=https://www.domain.com&
SF_IsExternal3D=1&
SF_ThreeDS_AuthenticationValue=kANBCCDDYJYjadADpka8KoQBXMqS&
SF_ThreeDS_DirectoryServerTransId=5340af8a-5505-4bf6-abcd-123412341234&
SF_ThreeDS_ECI=02&
SF_ThreeDS_Version=2.2.0&
signature=SJhKGxbbZlES%2Bi%2FMNwlcSAPELeKTHclTRQ5OWhWL4vU%3D

Response Fields

Parameter Name Description Example
TransType Indication of the Type of transaction meaning SALE(0)/AUTH(1)/CAPTURE(2) 0
Reply The reply code for the transaction - 000 = Approved / 553/001 = Pending / Anything else = Decline 000
TransID The ID for the transaction 21297
Date The date in which the transaction was processed 21/01/2023 16:15:24
Order Your unique order ID as it was sent as part of your original request 10101010
Amount The amount the transaction was processed at - in case of a conversion this would the actual amount processed 100.00
Payments The number of installments for the transaction in case this is an Installment transaction 1
Currency The Currency the transaction was processed at - in case of a conversion this would the actual Currency processed 1
ConfirmationNum In case of an AUTH transaction if the provider share an additional confirmation id it will be included 1234567
Comment The comment text as it was shared with the original transaction Deposit
ReplyDesc The description for the replycode as it was given by the provider or translated by the system SUCCESS
CCType The type of payment method used by the payer during the transaction Visa
Descriptor The descriptor for the transaction as it is configured in the system Testing Environment
RecurringSeries In case the trasnaction is part of a recurring series the series id will be included in the response
Last4 In case of a card transaction the last 4 digits of the card number will be included in the response 1111
ExpMonth In case the payment method used is a card the expiration month will be included in the response 11
ExpYear In case the payment method used is a card the expiration year will be included in the response 25
ccStorageID In case you have asked to store the card during the original transaction request the ccStorageID param will hold the id for this card
ccPublicReference In case you have asked to store the card during the original transaction request the ccPublicReference param will hold the identifer for this card/email to enable you to load the stored cards for the user in our hosted page
Source This field will represent the origin of the response - SILENTPOST means before the "Redirect" and APPROVED means after the "Redirect" SILENTPOST/APPROVED
debit_company When "Cashier mode" is enable for your account this will hold the id of the provider used to process the request 1
debit_refnum The unique identifier provided by the provider in their response - will be included in case the transaction reached the provider and wasnt blocked by the Risk rules in our system.
ccBIN The first 6 digits of the card number when the payment method used was a card 411111
OAmount The amount the transaction was initiated with - in case of a conversion this would the amount you sent to be processed 100.00
OCurrency The Currency the transaction was initiated with - in case of a conversion this would the Currency you sent to be processed 1
D3Redirect In case the response code is 553 which means redirect is needed this field will hold the url to redirect the customer to, url will be UrlEncoded so you will need to decode it before redirecting the customer https%3A%2F%2Fprocess%2Ecoriunder.cloud%2Fmember%2FremoteCharge%5FBack%2Easp%3FTransID%3D13920%26CompanyNum%3D5611630
signType SHA256
signature The response signature is built from the response params as listed below:

urlencode(base64( hash('sha256', replyCode + trans_id + trans_refNum+ trans_amount + trans_currency + merchanthash))) 		fRsVMBInoYUAz%2F%2B7%2BxLciuXSjjyRKEcR9%2FFdmndz0%2Bg%3D

Response example

Response
TransType=0&
Reply=000&
TransID=21297&Date=21/01/2023
16:15:24&
Order=10101010&
Amount=100.00&
Payments=1&
Currency=1&
ConfirmationNum=1234567&
Comment=Deposit&
ReplyDesc=SUCCESS&
CCType=Visa&
Descriptor=Testing Environment&
RecurringSeries=&
Last4=1111&
ExpMonth=11&
ExpYear=25&
ccStorageID=&
ccPublicReference=&
Source=SILENTPOST&
WalletID=&
debit_company=1&
debit_refnum=&
ccBIN=411111&
signType=SHA256&
signature=fRsVMBInoYUAz%2F%2B7%2BxLciuXSjjyRKEcR9%2FFdmndz0%2Bg%3D
3D Secure flow

Learn how to process 3DS transactions.
Status Check

Check the status of a specific transaction.
APM

Learn how to handle APM requests.