Integrating CadiPay with your Website

In order to process a payment on your website, you need to post certain information to CadiPay for the payment to be processed. You have to prepare a form on your website that will contain the fields in the table below. You can view demos of sample code here

Account and Information Security Fields
FieldValueRequiredDetails
xsp_midVaries by clientYesYour CadiPay Merchant ID
xsp_hashkeyVaries every timeYesThis is the fingerprint generated using an MD5 hashing algorithm on your Fingerprint, Merchant ID, Transaction ID, Currency Code and Pin.
xsp_ctypeSTANDARD, DONATION or BUTTONYesThis is the checkout type
xsp_transaction_pinVariesYesThis is a randaom 4 digit security pin that you create on each checkout
Transaction Information Fields
xsp_transaction_idVaries per checkoutYesThis is the Transaction ID for your order.
xsp_invoice_numVariesYesThis is the invoice number of your order.
xsp_currency_code YesCurrency code of the amount to be paid
xsp_methodLIVE or DEMOYesStatus of the order
Customer Information Fields
xsp_name YesCustomer’s first and last time
xsp_address YesCustomer’s address
xsp_city YesCustomer’s city
xsp_province YesCustomer’s province, state or region
xsp_country YesCustomer’s country
xsp_zip YesCustomer’s zip code
xsp_phone YesCustomer’s phone
xsp_email YesCustomer’s email
xsp_company OptionalCustomer’s company
Shipping Information Fields
xsp_shippingYES or NOYesStates wether the item is to be shipped or not
xsp_same_shippingYES or NODependsif xsp_shipping is set to YES, then xsp_same_shipping is required. If you set this field to YES, then the shipping details will be the same as the customer details, otherwise you have to provide the shipping information below
Shipping Details Fields
xsp_s_name DependsFull name of where the item is to be shipped
xsp_s_address DependsAddress of where the item is to be shipped
xsp_s_city DependsCity of where the item is to be shipped
xsp_s_province DependsProvince, state or region of where the item is to be shipped
xsp_s_country DependsCountry of where the item is to be shipped
xsp_s_zip DependsZIp code of where the item is to be shipped
xsp_s_phone DependsPhone of where the item is to be shipped
xsp_s_email DependsEmail of where the item is to be shipped
xsp_s_company OptionalCompany of where the item is to be shipped
Product Information Fields
xsp_i_1_description YesDescription of the item being purchased. If adding more than one item, then second item is xsp_i_2_description, third item is xsp_i_3_description e.t.c.
xsp_i_1_unit_price YesUnit price of the item being purchased. If adding more than one item, then second item is xsp_i_2_unit_price, third item is xsp_i_3_unit_price e.t.c.
xsp_i_1_qty YesQuantity of the item being purchased. If adding more than one item, then second item is xsp_i_2_qty, third item is xsp_i_3_qty e.t.c.
xsp_i_1_total YesTotal amount of the item being purchased. Maximum 2 decimal places. If adding more than one item, then second item is xsp_i_2_total, third item is xsp_i_3_total e.t.c.
Product Discount Information Fields
xsp_discount OptionalDiscount value to be applied on the total order
xsp_vat OptionalVAT value to be applied on the total order

The above information is to be posted to the URL:

https://www.cadipay.com/checkout/