ListMerchantCards Method

Description

The ListMerchantCards method lists the details of all cards registered under a specified Merchant.

Action

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

Style

Document

Input (Literal)

The input of this method is the document element ListMerchantCardsRequest 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.
ListMerchantCardsRequest Required
MerchantID Required	string		A unique identifier to identify the merchant.

Output (Literal)

The output of this method is the document element ListMerchantCardsResponse 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.
ListMerchantCardResponse Required
MerchantUserCard	MerchantUserCard		A bank card definition for a card registered for the Merchant.

Sample Messages

Request

<soapenv:Envelope
 	xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 	xmlns:v1="http://www.ecentricswitch.co.za/paymentgateway/v1">
 	<soapenv:Header>
 <v1:MessageHeader></v1:MessageHeader>
 	</soapenv:Header>
 	<soapenv:Body>
 		<ListMerchantCardsRequest xmlns="http://www.ecentricswitch.co.za/paymentgateway/v1">
 	        <v1:MerchantID>8B67BF88-BB8D-4EB5-ADFC-0F5C97C7ED67</v1:MerchantID>
 		</ListMerchantCardsRequest>
 	</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/v1""
			xmlns=""http://www.ecentricswitch.co.za/paymentgateway/v1""
			xmlns:xsd=""http://www.w3.org/2001/XMLSchema""
			xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"">
			<MessageDateTime>2024-11-07T12:33:18.427</MessageDateTime>
			<MessageID>FA4FAEFB-B2B1-4775-96D2-1CD0E8552A1C</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"">
		<ListMerchantCardsResponse
			xmlns=""http://www.ecentricswitch.co.za/paymentgateway/v1"">
			<MerchantUserCard>
				<MerchantUserID>978e566b-d62a-42c0-9843-381b3588f333</MerchantUserID>
				<CardholderName>8-2 Test Demo</CardholderName>
				<MaskedCardNumber>541333******1429</MaskedCardNumber>
				<ExpiryMonth>12</ExpiryMonth>
				<ExpiryYear>2025</ExpiryYear>
				<CardVerification>PaymentAuthentication</CardVerification>
			</MerchantUserCard>
			<MerchantUserCard>
				<MerchantUserID>978e566b-d62a-42c0-9843-381b3588f333</MerchantUserID>
				<CardholderName>8-2 Test Demo</CardholderName>
				<MaskedCardNumber>541333******1429</MaskedCardNumber>
				<ExpiryMonth>12</ExpiryMonth>
				<ExpiryYear>2025</ExpiryYear>
				<CardVerification>NoVerificationAction</CardVerification>
			</MerchantUserCard>
		</ListMerchantCardsResponse>
	</s:Body>
</s:Envelope>