X-Payments:Check cart callback request - Revision history

Dohtur at 11:49, 17 November 2016

2016-11-17T11:49:48Z

Dohtur at 13:44, 26 July 2016

2016-07-26T13:44:59Z

Dohtur: Created page with "After the customer has submitted credit card data, right before sending this data to the payment gateway, X-Payments connects to the store to verify the cart total and content..."

2016-07-20T08:47:14Z

Created page with "After the customer has submitted credit card data, right before sending this data to the payment gateway, X-Payments connects to the store to verify the cart total and content..."

New page

After the customer has submitted credit card data, right before sending this data to the payment gateway, X-Payments connects to the store to verify the cart total and contents.

The HTTP POST request is sent to the '''callbackURL''' defined in the '''Payment initialisation request'''.

===POSTed data===
{| cellspacing="0" cellpadding="2" border="1"
| colspan="1" | '''Field'''
| colspan="1" | '''Value'''
| colspan="1" | '''Type'''
| colspan="1" | '''Description'''
|-
| colspan="1" | action
| colspan="1" | check_cart
| colspan="1" | fixed string
| colspan="1" | Identifies the check-cart callback request
|-
| colspan="1" | txnId
| colspan="1" | (mixed)
| colspan="1" | string (MD5 hash)
| colspan="1" | A unique ID of the payment on the side of X-Payments
|-
| colspan="1" | refId
| colspan="1" | (mixed)
| colspan="1" | string
| colspan="1" | Order ID (or any other reference) in the online store
|}
<br />
As of API v1.3, the store must respond to this callback request. The response must be an encrypted XML document (i.e. the same way as for other communication between the store and X-Payments).

===Encrypted response for check-cart callback request===
{| cellspacing="0" cellpadding="2" border="1"
| colspan="1" | '''Field'''
| colspan="1" | '''Required'''
| colspan="1" | '''Type'''
| colspan="1" | '''Description'''
|-
| colspan="1" | status
| colspan="1" | Y
| colspan="1" | fixed string
| colspan="1" | Should be "cart-changed" or "cart-not-changed"
|-
| colspan="1" | cart
| colspan="1" | Y
| colspan="1" | container
| colspan="1" | A container with cart/order description. See [[X-Payments:API#Request_specification|Payment initialisation request specification]] for details. This container must be included for "status = cart-changed" and is not necessary for "status = cart-not-changed"
|-
| colspan="1" | saveCard
| colspan="1" | N
| colspan="1" | string
| colspan="1" | Whether the customer has chosen to save their card for future use ("Y" if the customer would like to save the card)
|}
<br /><br />

← Older revision		Revision as of 13:44, 26 July 2016
Line 1:		Line 1:
		+	<noinclude>{{XP_API_TOC}}</noinclude>
	After the customer has submitted credit card data, right before sending this data to the payment gateway, X-Payments connects to the store to verify the cart total and contents.		After the customer has submitted credit card data, right before sending this data to the payment gateway, X-Payments connects to the store to verify the cart total and contents.

@@ Line 4: / Line 4: @@
 The HTTP POST request is sent to the '''callbackURL''' defined in the '''Payment initialisation request'''.
-===POSTed data===
+{{Note|As of API v1.3, the store must respond to this callback request. The response must be an encrypted XML document (i.e. the same way as for other communication between the store and X-Payments).}}
 {| cellspacing="0" cellpadding="2" border="1"
 | colspan="1" | '''Field'''
@@ Line 27: / Line 29: @@
 |}
 <br />
 ===Encrypted response for check-cart callback request===