ListUserCards Method

Description

The ListUserCards method lists the details of all cards registered to a specific merchant.

Action

http://www.ecentricswitch.co.za/paymentgateway/v1/ListUserCards

Style

Document

Input (Literal)

The input of this method is the document element ListUserCardsRequest having the structure defined by the following table.

ELEMENT	TYPE	SIZE(MAX)	DESCRIPTION
MessageHeader
MessageDateTime	datetime		The message timestamp.
MessageID	string	50	A unique identifier to identify the message.
Channel	string	50	An identifier to identify the source of the message.
ListUserCardsRequest Required
MerchantID Required	string	50	A unique identifier to identify the merchant.
MerchantUserID Required	string	50	It is an identifier for the user account on whose behalf the merchant is listing the user cards.

Output (Literal)

The output of this method is the document element CaptureResponse having the structure defined by the following table.

ELEMENT	TYPE	SIZE(MAX)	DESCRIPTION
MessageHeader Required
MessageDateTime	datetime		The message timestamp.
MessageID	string	50	A unique identifier to identify the message.
Channel	string	50	An identifier to identify the source of the message.
ListUserCardsResponse Required
UserCard	UserCard		A bank card definition for a registered card.

Sample Messages

Request

<soapenv:Envelope
 	xmlns:soapenv=""http://schemas.xmlsoap.org/soap/envelope/""
 	xmlns:v1=""http://www.ecentricswitch.co.za/paymentgateway/v1"">
 	<soapenv:Header>
 		<MessageHeader></MessageHeader>
 	</soapenv:Header>
 	<soapenv:Body>
 		<ListUserCardsRequest xmlns=""http://www.ecentricswitch.co.za/paymentgateway/v1"">
 			<MerchantID>8B67BF88-BB8D-4EB5-ADFC-0F5C97C7ED67</MerchantID>
 			<MerchantUserID>978e566b-d62a-42c0-9843-381b3588f333</MerchantUserID>
 		</ListUserCardsRequest>
 	</soapenv:Body>
 </soapenv:Envelope>

Response

<s:Envelope xmlns:s=""http://schemas.xmlsoap.org/soap/envelope/"">
	<s:Header>
		<h:MessageHeader
			xmlns:h=""http://www.ecentricswitch.co.za/paymentgateway/v1v1""
			xmlns=""http://www.ecentricswitch.co.za/paymentgateway/v1v1""
			xmlns:xsd=""http://www.w3.org/2001/XMLSchema""
			xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"">
			<MessageDateTime>2024-11-07T12:32:11.063</MessageDateTime>
			<MessageID>BA58C6D4-CA2C-4256-AA6B-4D88B55AAB15</MessageID>
			<Channel xsi:nil=""true""/>
		</h:MessageHeader>
	</s:Header>
	<s:Body
		xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance""
		xmlns:xsd=""http://www.w3.org/2001/XMLSchema"">
		<ListUserCardsResponse
			xmlns=""http://www.ecentricswitch.co.za/paymentgateway/v1v1"">
			<UserCard>
				<Token>081C1396-493D-4E09-81F9-749CE53E0CDE</Token>
				<CardholderName>8-2 Test Demo</CardholderName>
				<MaskedCardNumber>541333******1429</MaskedCardNumber>
				<ExpiryMonth>12</ExpiryMonth>
				<ExpiryYear>2025</ExpiryYear>
				<CardVerification>PaymentAuthentication</CardVerification>
				<NetworkTokenStatus>NotApplicable</NetworkTokenStatus>
				<NetworkTokenizationFailureReason xsi:nil=""true""/>
				<NetworkTokenizationFailureMessage xsi:nil=""true""/>
			</UserCard>
			<UserCard>
				<Token>105B5E8F-4475-4067-80F7-F1BDFC7FFDC2</Token>
				<CardholderName>8-2 Test Demo</CardholderName>
				<MaskedCardNumber>541333******1429</MaskedCardNumber>
				<ExpiryMonth>12</ExpiryMonth>
				<ExpiryYear>2025</ExpiryYear>
				<CardVerification>NoVerificationAction</CardVerification>
				<NetworkTokenStatus>NotApplicable</NetworkTokenStatus>
				<NetworkTokenizationFailureReason xsi:nil=""true""/>
				<NetworkTokenizationFailureMessage xsi:nil=""true""/>
			</UserCard>
		</ListUserCardsResponse>
	</s:Body>
</s:Envelope>