Siebel CRM Web Services Reference > Siebel CRM Primary Web Services >
LoyaltyMemberService
Use this Web service to do the following member service actions:
- Inquire membership details
- Process membership information for Renewal or Cancellation
- Retrieve member service price details
- Purchase or Transfer points
LoyaltyMemberService Operations
For a list of operations associated with this Web service, see Table 284.
Table 284. LoyaltyMemberService Operations
|
|
PurchasePointsService |
Used for purchasing points. The member provides a membership number, the point type he or she wants to purchase, and the number of points as input. Credit card details must also be given as the service might involve monetary payment. Once the service is complete, output is given as an XML file that shows the transaction number and the order number. Member point balances are updated accordingly and reflected in the Siebel Loyalty application. |
TransferPointsService |
Used for transferring points to another member. The member provides a membership number, the point type which he or she wants to purchase, and the number of points as input. The transferee member number must also be included as input. Credit card details must also be given as the service might involve monetary payment. Once the service is performed, output is given as an XML file that shows the transaction number and the order number. Members' (transferor and transferee) point balances are updated accordingly and reflected in the Siebel Loyalty application. |
LoungePurchaseService |
Used to buy or renew Lounge. The member provides a membership number, lounge period type, and lounge period duration along with credit card details. The member must also provide payment mode (Pay, Points, or Points+Pay) along with currency, and point type details as the service might involve payment. After the service is performed, the Member's Lounge details are updated and a transaction detail record is created. |
MembershipCancellationService |
Used to cancel a loyalty membership. The member provides a membership number and credit card information (using the same credit card used during membership enrollment, or renewal). The loyalty program fee is refunded to the member's credit card, and membership is cancelled. |
RenewMembershipService |
Renews the loyalty membership for members who are not enrolled in lifetime membership plans. The member provides a membership number, and membership scheme along with payment details (payment mode, credit card details and point type details) as the input. Membership dates are updated along with the membership scheme after the service is performed successfully. |
GetMemberServicePrice |
The member provides a membership number, and member service name to obtain price lists in different payment modes. Output is an integration object that can be seen as an XML file. |
MemberInquiry |
Used to query for a member or members given the member names, member number, and so on. The output details include member loyalty information, contact addresses, phone numbers, and email addresses, and so on. |
PromotionEnrolmentForSMS |
Rewards members a referral bonus when their social networking friends enroll into promotions. |
Request Message Description: PurchasePointsService
For a description of this request message, see Table 285.
Table 285. Request Message Description: PurchasePointsService
|
|
|
Member Number |
Required. The requesting member must provide the Siebel Loyalty membership number. |
String |
Point Type |
Required. The purchasing member must specify the type of point that he or she wants to purchase. |
String |
Points |
Required. The purchasing member must specify the number of points that he or she wants to purchase. |
String |
Billing Address |
Member billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Address2 |
Members secondary billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing City |
Member billing city. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Country |
Member billing country. Required if monetary or credit card details are a part of the transaction. |
String |
Billing State |
Member billing state. Required if monetary or credit card details are a part of the transaction. |
String |
Billing ZIP Code |
Member billing ZIP code. Required if monetary or credit card details are a part of the transaction. |
String |
CVV Number |
CVV number from member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Card Holder Name |
Credit card holder's name. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Number |
Credit card number. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Type |
Credit card type, such as Visa, MasterCard, and so on. Required if monetary or credit card details are a part of the transaction. |
String |
Currency |
Currency type used by member. Required if monetary currency is part of the transaction. |
String |
Expiration Month |
Expiration month of member credit cards. Required if monetary or credit card details are a part of the transaction. |
String |
Expiration Year |
Expiration year of member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Override Flag |
Override flag. |
String |
Override Pay |
Required. If the member wants to override the price details, then the input is Y, if not, then the input is N. |
String |
Override Reason |
The member must specify Override Pay when the Override flag is marked Y. It is the monetary amount overridden by the member. |
String |
Override Reason Code |
A reason for the price list override is stated if this flag is set to Y. |
String |
Response Message Description: PurchasePointsService
For a description of this response message, see Table 286.
Table 286. Response Message Description: PurchasePointsService
|
|
|
Error Message |
Error message given if the transaction fails. |
String |
Order Id |
Order ID of the point purchase service. |
String |
Quote Id |
Quote ID of the point purchase service. |
String |
Siebel Response Code |
Siebel Order Management response code following authorization of a credit card. |
String |
Siebel Response Message |
Siebel Order Management response message following authorization of a credit card. |
String |
Transaction Number |
The transaction number of the point purchase service. |
String |
Request Message Description: TransferPointService
For a description of this request message, see Table 287.
Table 287. Request Message Description: TransferPointService
|
|
|
Member Number |
Required. The requesting member must provide the Siebel Loyalty membership number. |
String |
Point Type |
Required. The purchasing member must specify the type of point that he or she wants to purchase. |
String |
Points |
Required. The purchasing member must specify the number of points that he or she wants to purchase. |
String |
Transferee Member Number |
Required. Transferee membership number to whom the points are to be transferred. |
String |
Billing Address |
Member billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Address2 |
Members secondary billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing City |
Member billing city. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Country |
Member billing country. Required if monetary or credit card details are a part of the transaction. |
String |
Billing State |
Member billing state. Required if monetary or credit card details are a part of the transaction. |
String |
Billing ZIP Code |
Member billing ZIP code. Required if monetary or credit card details are a part of the transaction. |
String |
CVV Number |
CVV number from member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Card Holder Name |
Credit card holder's name. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Number |
Credit card number. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Type |
Credit card type, such as Visa, MasterCard, and so on. Required if monetary or credit card details are a part of the transaction. |
String |
Currency |
Currency type used by member. Required if monetary currency is part of the transaction. |
String |
Expiration Month |
Expiration month of member credit cards. Required if monetary or credit card details are a part of the transaction. |
String |
Expiration Year |
Expiration year of member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Override Flag |
Override flag. |
String |
Override Pay |
Required. If the member wants to override the price details, then the input is Y, if not, then the input is N. |
String |
Override Reason |
The member must specify Override Pay when the Override flag is marked Y. It is the monetary amount overridden by the member. |
String |
Override Reason Code |
A reason for the price list override is stated if this flag is set to Y. |
String |
Response Message Description: TransferPointService
For a description of this response message, see Table 288.
Table 288. Response Message Description: TransferPointService
|
|
|
Error Message |
Error message given if the transaction fails. |
String |
Order Id |
Order ID of the point purchase service. |
String |
Quote Id |
Quote ID of the point purchase service. |
String |
Siebel Response Code |
Siebel Order Management response code following authorization of a credit card. |
String |
Siebel Response Message |
Siebel Order Management response message following authorization of a credit card. |
String |
Transaction Number |
The transaction number of the point purchase service. |
String |
Request Message Description: LoungePurchaseService
For a description of this request message, see Table 289.
Table 289. Request Message Description: LoungePurchaseService
|
|
|
Member Number |
Required. The requesting member must provide the Siebel Loyalty Membership Number. |
String |
Lounge Period Type |
Required. Lounge period type as months or years. |
String |
Lounge Period Duration |
Lounge period duration for renewal stated in months or years. |
String |
Billing Address |
Member billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Address2 |
Members secondary billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing City |
Member billing city. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Country |
Member billing country. Required if monetary or credit card details are a part of the transaction. |
String |
Billing State |
Member billing state. Required if monetary or credit card details are a part of the transaction. |
String |
Billing ZIP Code |
Member billing ZIP code. Required if monetary or credit card details are a part of the transaction. |
String |
CVV Number |
CVV number from member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Card Holder Name |
Credit card holder's name. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Number |
Credit card number. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Type |
Credit card type, such as Visa, MasterCard, and so on. Required if monetary or credit card details are a part of the transaction. |
String |
Currency |
Currency type used by member. Required if monetary currency is part of the transaction. |
String |
Expiration Month |
Expiration month of member credit cards. Required if monetary or credit card details are a part of the transaction. |
String |
Expiration Year |
Expiration year of member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Override Flag |
Override flag. |
String |
Override Pay |
Required. If the member wants to override the price details, then the input is Y, if not, then the input is N. |
String |
Override Points |
The member must specify Override Pay when the Override flag is marked Y. It is the monetary amount overridden by the member. |
String |
Override Reason |
A reason for the price list override is stated if this flag is set to Y. |
String |
Override Reason Code, |
A reason for the price list override is stated if this flag is set to Y. |
String |
Payment Mode |
Required. Payment mode stated as Points or Points+Pay, or Pay. |
String |
Point Type |
Point type. |
String |
Response Message Description: LoungePurchaseService
For a description of this response message, see Table 290.
Table 290. Response Message Description: LoungePurchaseService
|
|
|
Error Message |
Error message given if the transaction fails. |
String |
Order Id |
Order ID of the point purchase service. |
String |
Quote Id |
Quote ID of the point purchase service. |
String |
Siebel Response Code |
Siebel Order Management response code following authorization of a credit card. |
String |
Siebel Response Message |
Siebel Order Management response message following authorization of a credit card. |
String |
Transaction Number |
The transaction number of the point purchase service. |
String |
Request Message Description: RenewMembershipService
Table 291. Request Message Description: RenewMembershipService
|
|
|
Member Number |
Required. The requesting member must provide the Siebel Loyalty Membership Number. |
String |
Membership Scheme |
Required. The membership scheme to be renewed. |
String |
Billing Address |
Member billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Address2 |
Members' secondary billing address. Required if monetary or credit card details are a part of the transaction. |
String |
Billing City |
Member billing city. Required if monetary or credit card details are a part of the transaction. |
String |
Billing Country |
Member billing country. Required if monetary or credit card details are a part of the transaction. |
String |
Billing State |
Member billing state. Required if monetary or credit card details are a part of the transaction. |
String |
Billing ZIP Code |
Member billing ZIP code. Required if monetary or credit card details are a part of the transaction. |
String |
CVV Number |
CVV number from member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Card Holder Name |
Credit card holder's name. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Number |
Credit card number. Required if monetary or credit card details are a part of the transaction. |
String |
Credit Card Type |
Credit card type, such as Visa, MasterCard, and so on. Required if monetary or credit card details are a part of the transaction. |
String |
Currency |
Currency type used by member. Required if monetary currency is part of the transaction. |
String |
Expiration Month |
Expiration month of member credit cards. Required if monetary or credit card details are a part of the transaction. |
String |
Expiration Year |
Expiration year of member credit card. Required if monetary or credit card details are a part of the transaction. |
String |
Override Flag |
Override flag. |
String |
Override Pay |
Required. If the member wants to override the price details, then the input is Y, if not, then the input is N. |
String |
Override Points |
The member must specify Override Pay when the Override flag is marked Y. It is the monetary amount overridden by the member. |
String |
Override Reason |
A reason for the price list override is stated if this flag is set to Y. |
String |
Override Reason Code |
A reason for the price list override is stated if this flag is set to Y. |
String |
Payment Mode |
Required. Payment mode stated as Points or Points+Pay, or Pay. |
String |
Point Type |
Point type. |
String |
For a description of this request message, see Table 291. Response Message Description: RenewMembershipService
For a description of this response message, see Table 292.
Table 292. Response Message Description: RenewMembershipService
|
|
|
Error Message |
Error message given if the transaction fails. |
String |
Order Id |
Order ID of the point purchase service. |
String |
Quote Id |
Quote ID of the point purchase service. |
String |
Siebel Response Code |
Siebel Order Management response code following authorization of a credit card. |
String |
Siebel Response Message |
Siebel Order Management response message following authorization of a credit card. |
String |
Transaction Number |
The transaction number of the point purchase service. |
String |
Request Message Description: MembershipCancellationService
For a description of this request message, see Table 293.
Table 293. Request Message Description: MembershipCancellationService
|
|
|
Member Number |
Required. The requesting member must provide the Loyalty Membership Number. |
String |
Fee Refund Basis |
Required. Fee refund basis. Values include Prorata or Percentage, or No Refund. |
String |
Refund Percentage |
Refund percentage is to be given if the selected fee refund basis is calculated as a percentage. |
String |
Cancellation Reason |
Reason for the membership cancellation. |
String |
Cancellation Reason Code |
Required. Membership cancellation reason code. |
String |
Credit Card Number |
Credit card number. Required when the refund basis is Percentage or Prorata. The fee is refunded to the credit card number provided that it matches the number previously retained. |
String |
Credit Card Type |
Credit card type, such as Visa, MasterCard, and so on. Required when the refund basis is Percentage or Prorata. The fee is refunded to the credit card number provided that it matches the number previously on file. |
String |
Expiration Month |
Expiration month must match the expiration month of the credit card on file. Required when the refund basis is Percentage or Prorata. |
String |
Expiration Year |
Expiration year must match the expiration year of the credit card on file. Required when the refund basis is Percentage or Prorata. |
String |
Override Flag |
Required. If the member wants to override the refund price details, then the input is Y, if not, then the input is N. |
String |
Override Pay |
Required. If the member wants to override the price details then the input is Y, if not, then the input is N. |
String |
Override Reason |
Reason for overriding price. |
String |
Override Reason Code |
Override reason code provided if the Override Flag is Y. |
String |
Response Message Description: MembershipCancellationService
For a description of this response message, see Table 294.
Table 294. Response Message Description: MembershipCancellationService
|
|
|
Currency |
Currency in which the fee is refunded. |
String |
Error Message |
Error message if the transaction fails. |
String |
Order Id |
Refund Order ID of the membership cancellation service. |
String |
Quote Id |
Quote ID of the membership cancellation service. |
String |
Refund Amount |
Refund amount. |
String |
Siebel Response Code |
Response code provided by Siebel Order Management after the credit card authorization is sent. |
String |
Siebel Response Message |
Response message given by Siebel Order Management after credit card authorization. |
String |
Transaction Number |
The transaction number of the membership cancellation. |
String |
Request Message Description: GetMemberServicePrice
For a description of this request message, see Table 295.
Table 295. Request Message Description: GetMemberServicePrice
|
|
|
Member Number |
The requesting member must provide the Siebel Loyalty Membership Number. |
String |
Currency Code |
Currency code to return price lists in a given currency. |
String |
Lounge Period Duration |
The Lounge period duration must be provided if the Transaction Sub Type is set to Lounge Purchase. |
String |
Lounge Period Type |
Lounge Period type (Months or Years, and so on) must be provided if the Transaction Sub Type is set to Lounge Purchase. |
String |
Point Type |
Point type must be provided if the member wants to see price lists of Points, or Points + Pay mode in the given point type. |
String |
Points Qty |
Number of points to be given if the transaction sub type is set to Purchase Points or Transfer Points. |
String |
Selected Membership Scheme |
Membership scheme included in the input if the Transaction Sub Type is Membership Renewal. |
String |
Transaction Sub Type |
Required. Member Service type. Possible values are: Points Purchase, Transfer Points, Membership Renewal, or Lounge Purchase. |
String |
Response Message Description: GetMemberServicePrice
For a description of this response message, see Table 296.
Table 296. Response Message Description: GetMemberServicePrice
|
|
|
LOY EAI Transaction |
List of price lines, after applying the promotions on the base prices, are given in the output as XML file. |
Integration Object |
Request Message Description: MemberInquiry
For a description of this request message, see Table 297.
Table 297. Request Message Description: MemberInquiry
|
|
|
Member Number |
The requesting member must provide the Siebel Loyalty Membership Number. |
String |
Email Address |
Email address of inquiring member. |
String |
First Name |
Member's first name. |
String |
Last Name |
Member's last name. |
String |
Middle Name |
Member's middle name. |
String |
Telephone Number |
Member's telephone number. |
String |
Transaction Type |
Transaction type must be provided for queries. |
String |
ZIP Code |
ZIP code of the member whose details are to be inquired is given. |
String |
Response Message Description: GetMemberServicePrice
For a description of this response message, see Table 298.
Table 298. Response Message Description: GetMemberServicePrice
|
|
|
Siebel Message (An instance of the integration object LOY Member Inquiry) |
Member details are given in the integration object and can be extracted as XML file. |
Integration Object |
Request Message Description: PromotionEnrolmentForSMS
For a description of this request message, see Table 299.
Table 299. Request Message Description: PromotionEnrolmentForSMS
|
|
|
Member Number |
Required. The member number of the enrollee. |
String |
Enrolled Promotion Id |
Required. The enrolled promotion ID. |
String |
Incentive Choice |
Optional. Incentive choice type. |
String |
Referred By Member Number |
Optional. Member number of referee. |
String |
Response Message Description: PromotionEnrolmentForSMS
For a description of this response message, see Table 300.
Table 300. Response Message Description: PromotionEnrolmentForSMS
|
|
|
Error Message |
Error message. |
String |
Siebel Message |
Transactions in integration object format. |
Integration Object |
Example Package for LoyaltyMemberServices
To view an example of messages for this Web service, navigate to the documentation library for Siebel Business Applications on Oracle Technology Network, and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. Request
See the following file to view the sample code: ...\LoyaltyMemberServices\Request.xml
Response
See the following file to view the sample code: ...\LoyaltyMemberServices\Response.xml
Interface Description (WSDL) for LoyaltyMemberServices
To view the interface description for this Web service, navigate to the documentation library for Siebel Business Applications on Oracle Technology Network, and click the Related Files link next to the link for Siebel CRM Web Services Reference to access a zip file. Extract the files in the zip file. ...\LoyaltyMemberService\WSDL
|