public override string RecurringBillingCreateSubscription(String SubscriptionDescription, Customer ThisCustomer, Address UseBillingAddress, Address UseShippingAddress, Decimal RecurringAmount, DateTime StartDate, int RecurringInterval, DateIntervalTypeEnum RecurringIntervalType, int OriginalRecurringOrderNumber, string XID, IDictionary <string, string> TransactionContext, out String RecurringSubscriptionID, out String RecurringSubscriptionCommand, out String RecurringSubscriptionResult)
{
string result = string.Empty;
try
{
//Re-Use the Internal Gateway Recurring Billing logic for calculating how much of the order is recurring
ShoppingCart recurringCart = new ShoppingCart(ThisCustomer.SkinID, ThisCustomer, CartTypeEnum.RecurringCart, OriginalRecurringOrderNumber, false);
CreditCardDetailsType creditCard = new CreditCardDetailsType();
if (UseBillingAddress.CardNumber != null && UseBillingAddress.CardNumber.Length > 0)
{
creditCard.CreditCardNumber = UseBillingAddress.CardNumber;
creditCard.ExpMonth = Localization.ParseUSInt(UseBillingAddress.CardExpirationMonth);
creditCard.ExpYear = Localization.ParseUSInt(UseBillingAddress.CardExpirationYear);
creditCard.ExpMonthSpecified = true;
creditCard.ExpYearSpecified = true;
creditCard.CVV2 = XID;
if (UseBillingAddress.CardType == "AmericanExpress")
{
creditCard.CreditCardType = (CreditCardTypeType)Enum.Parse(typeof(CreditCardTypeType), "Amex", true);
}
else
{
creditCard.CreditCardType = (CreditCardTypeType)Enum.Parse(typeof(CreditCardTypeType), UseBillingAddress.CardType, true);
}
creditCard.CreditCardTypeSpecified = true;
}
else
{
creditCard.CreditCardTypeSpecified = false;
}
BasicAmountType recurringAmount = new BasicAmountType();
recurringAmount.currencyID = (CurrencyCodeType)Enum.Parse(typeof(CurrencyCodeType), AppLogic.AppConfig("Localization.StoreCurrency"), true);
recurringAmount.Value = RecurringAmount.ToString();
DateIntervalTypeEnum recurringIntervalType = recurringCart.CartItems[0].RecurringIntervalType; //We currently only support 1 interval per recurring order, so grabbing the first as a default should be safe
int recurringInterval = recurringCart.CartItems[0].RecurringInterval;
BillingPeriodDetailsType billingPeriodDetails = PayPalController.GetECRecurringPeriodDetails(recurringIntervalType, recurringInterval);
billingPeriodDetails.Amount = recurringAmount;
billingPeriodDetails.TotalBillingCyclesSpecified = false;
ScheduleDetailsType scheduleDetails = new ScheduleDetailsType();
scheduleDetails.Description = string.Format("Recurring order created on {0} from {1}", System.DateTime.Now.ToShortDateString(), AppLogic.AppConfig("StoreName"));
scheduleDetails.MaxFailedPayments = 0;
scheduleDetails.MaxFailedPaymentsSpecified = true;
scheduleDetails.AutoBillOutstandingAmount = AutoBillType.NoAutoBill;
scheduleDetails.AutoBillOutstandingAmountSpecified = true;
scheduleDetails.PaymentPeriod = billingPeriodDetails;
RecurringPaymentsProfileDetailsType profileDetails = new RecurringPaymentsProfileDetailsType();
profileDetails.SubscriberName = ThisCustomer.FirstName + " " + ThisCustomer.LastName;
profileDetails.BillingStartDate = StartDate;
CreateRecurringPaymentsProfileRequestDetailsType profileRequestDetails = new CreateRecurringPaymentsProfileRequestDetailsType();
profileRequestDetails.ScheduleDetails = scheduleDetails;
profileRequestDetails.RecurringPaymentsProfileDetails = profileDetails;
profileRequestDetails.CreditCard = creditCard;
if (!(UseBillingAddress.CardNumber != null && UseBillingAddress.CardNumber.Length > 0))
{
profileRequestDetails.Token = XID;
}
if (recurringCart.IsAllDownloadComponents())
{
PaymentDetailsItemType paymentDetailsItem = new PaymentDetailsItemType();
paymentDetailsItem.ItemCategory = ItemCategoryType.Digital;
paymentDetailsItem.ItemCategorySpecified = true;
List <PaymentDetailsItemType> paymentDetailsList = new List <PaymentDetailsItemType>();
paymentDetailsList.Add(paymentDetailsItem);
profileRequestDetails.PaymentDetailsItem = paymentDetailsList.ToArray();
}
CreateRecurringPaymentsProfileRequestType profileRequest = new CreateRecurringPaymentsProfileRequestType();
profileRequest.Version = API_VER;
profileRequest.CreateRecurringPaymentsProfileRequestDetails = profileRequestDetails;
CreateRecurringPaymentsProfileReq request = new CreateRecurringPaymentsProfileReq();
request.CreateRecurringPaymentsProfileRequest = profileRequest;
CreateRecurringPaymentsProfileResponseType profileResponse = new CreateRecurringPaymentsProfileResponseType();
profileResponse = IPayPal.CreateRecurringPaymentsProfile(request);
if (profileResponse != null && profileResponse.Ack.ToString().StartsWith("success", StringComparison.InvariantCultureIgnoreCase))
{
result = AppLogic.ro_OK;
}
else
{
if (profileResponse.Errors != null)
{
bool first = true;
for (int ix = 0; ix < profileResponse.Errors.Length; ix++)
{
if (!first)
{
result += ", ";
}
result += profileResponse.Errors[ix].LongMessage;
first = false;
}
}
}
RecurringSubscriptionID = (profileResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID == null ? "No ProfileID provided" : profileResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID);
RecurringSubscriptionCommand = string.Empty;
RecurringSubscriptionResult = (profileResponse.CreateRecurringPaymentsProfileResponseDetails.DCCProcessorResponse == null ? "No response provided" : profileResponse.CreateRecurringPaymentsProfileResponseDetails.DCCProcessorResponse);
//Log the transaction
OrderTransactionCollection ecRecurringOrderTransaction = new OrderTransactionCollection(OriginalRecurringOrderNumber);
ecRecurringOrderTransaction.AddTransaction("PayPal Express Checkout Recurring Profile Creation",
request.ToString(),
result,
string.Empty,
(profileResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID == null ? "No ProfileID provided" : profileResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID),
AppLogic.ro_PMPayPalExpress,
null,
RecurringAmount);
}
catch
{
result = "Recurring Profile Creation Failed.";
RecurringSubscriptionID = string.Empty;
RecurringSubscriptionCommand = string.Empty;
RecurringSubscriptionResult = result;
}
return(result);
}
// # CreateRecurringPaymentsProfile API Operation
// The CreateRecurringPaymentsProfile API operation creates a recurring payments profile.
// You must invoke the CreateRecurringPaymentsProfile API operation for each profile you want to create.
// The API operation creates a profile and an associated billing agreement.
// Note:
// There is a one-to-one correspondence between billing agreements and recurring payments profiles.
// To associate a recurring payments profile with its billing agreement,
// you must ensure that the description in the recurring payments profile matches the description of a billing agreement.
// For version 54.0 and later, use SetExpressCheckout to initiate creation of a billing agreement.
public CreateRecurringPaymentsProfileResponseType CreateRecurringPaymentsProfileAPIOperation()
{
// Create the CreateRecurringPaymentsProfileResponseType object
CreateRecurringPaymentsProfileResponseType responseCreateRecurringPaymentsProfileResponseType = new CreateRecurringPaymentsProfileResponseType();
try
{
// Create the CreateRecurringPaymentsProfileReq object
CreateRecurringPaymentsProfileReq createRecurringPaymentsProfile = new CreateRecurringPaymentsProfileReq();
// Create the CreateRecurringPaymentsProfileRequestType object
CreateRecurringPaymentsProfileRequestType createRecurringPaymentsProfileRequest = new CreateRecurringPaymentsProfileRequestType();
// You can include up to 10 recurring payments profiles per request. The
// order of the profile details must match the order of the billing
// agreement details specified in the SetExpressCheckout request which
// takes mandatory argument:
//
// * `billing start date` - The date when billing for this profile begins.
// `Note:
// The profile may take up to 24 hours for activation.`
RecurringPaymentsProfileDetailsType recurringPaymentsProfileDetails
= new RecurringPaymentsProfileDetailsType("2013-12-31T13:01:19+00:00");
// Billing amount for each billing cycle during this payment period.
// This amount does not include shipping and tax amounts.
// `Note:
// All amounts in the CreateRecurringPaymentsProfile request must have
// the same currency.`
BasicAmountType billingAmount = new BasicAmountType(CurrencyCodeType.USD, "3.00");
// Regular payment period for this schedule which takes mandatory
// params:
//
// * `Billing Period` - Unit for billing during this subscription period. It is one of the
// following values:
// * Day
// * Week
// * SemiMonth
// * Month
// * Year
// For SemiMonth, billing is done on the 1st and 15th of each month.
// `Note:
// The combination of BillingPeriod and BillingFrequency cannot exceed
// one year.`
// * `Billing Frequency` - Number of billing periods that make up one billing cycle.
// The combination of billing frequency and billing period must be less
// than or equal to one year. For example, if the billing cycle is
// Month, the maximum value for billing frequency is 12. Similarly, if
// the billing cycle is Week, the maximum value for billing frequency is
// 52.
// `Note:
// If the billing period is SemiMonth, the billing frequency must be 1.`
// * `Billing Amount`
BillingPeriodDetailsType paymentPeriod = new BillingPeriodDetailsType(BillingPeriodType.DAY, Convert.ToInt32("5"), billingAmount);
// Describes the recurring payments schedule, including the regular
// payment period, whether there is a trial period, and the number of
// payments that can fail before a profile is suspended which takes
// mandatory params:
//
// * `Description` - Description of the recurring payment.
// `Note:
// You must ensure that this field matches the corresponding billing
// agreement description included in the SetExpressCheckout request.`
// * `Payment Period`
ScheduleDetailsType scheduleDetails = new ScheduleDetailsType("description", paymentPeriod);
// `CreateRecurringPaymentsProfileRequestDetailsType` which takes
// mandatory params:
//
// * `Recurring Payments Profile Details`
// * `Schedule Details`
CreateRecurringPaymentsProfileRequestDetailsType createRecurringPaymentsProfileRequestDetails
= new CreateRecurringPaymentsProfileRequestDetailsType(recurringPaymentsProfileDetails, scheduleDetails);
// Either EC token or a credit card number is required.If you include
// both token and credit card number, the token is used and credit card number is
// ignored
// In case of setting EC token,
// `createRecurringPaymentsProfileRequestDetails.Token = "EC-5KH01765D1724703R";`
// A timestamped token, the value of which was returned in the response
// to the first call to SetExpressCheckout. Call
// CreateRecurringPaymentsProfile once for each billing
// agreement included in SetExpressCheckout request and use the same
// token for each call. Each CreateRecurringPaymentsProfile request
// creates a single recurring payments profile.
// `Note:
// Tokens expire after approximately 3 hours.`
// Credit card information for recurring payments using direct payments.
CreditCardDetailsType creditCard = new CreditCardDetailsType();
// Type of credit card. For UK, only Maestro, MasterCard, Discover, and
// Visa are allowable. For Canada, only MasterCard and Visa are
// allowable and Interac debit cards are not supported. It is one of the
// following values:
//
// * Visa
// * MasterCard
// * Discover
// * Amex
// * Solo
// * Switch
// * Maestro: See note.
// `Note:
// If the credit card type is Maestro, you must set currencyId to GBP.
// In addition, you must specify either StartMonth and StartYear or
// IssueNumber.`
creditCard.CreditCardType = CreditCardTypeType.VISA;
// Credit Card Number
creditCard.CreditCardNumber = "4442662639546634";
// Credit Card Expiration Month
creditCard.ExpMonth = Convert.ToInt32("12");
// Credit Card Expiration Year
creditCard.ExpYear = Convert.ToInt32("2016");
createRecurringPaymentsProfileRequestDetails.CreditCard = creditCard;
createRecurringPaymentsProfileRequest.CreateRecurringPaymentsProfileRequestDetails
= createRecurringPaymentsProfileRequestDetails;
createRecurringPaymentsProfile.CreateRecurringPaymentsProfileRequest = createRecurringPaymentsProfileRequest;
// # Create the service wrapper object to make the API call
PayPalAPIInterfaceServiceService service = new PayPalAPIInterfaceServiceService();
// # API call
// Invoke the CreateRecurringPaymentsProfile method
responseCreateRecurringPaymentsProfileResponseType
= service.CreateRecurringPaymentsProfile(createRecurringPaymentsProfile);
if (responseCreateRecurringPaymentsProfileResponseType != null)
{
// Response envelope acknowledgement
string acknowledgement = "CreateRecurringPaymentsProfile API Operation - ";
acknowledgement += responseCreateRecurringPaymentsProfileResponseType.Ack.ToString();
logger.Info(acknowledgement + "\n");
Console.WriteLine(acknowledgement + "\n");
// # Success values
if (responseCreateRecurringPaymentsProfileResponseType.Ack.ToString().Trim().ToUpper().Equals("SUCCESS"))
{
// A unique identifier for future reference to the details of this recurring payment
logger.Info("Profile ID : " + responseCreateRecurringPaymentsProfileResponseType.CreateRecurringPaymentsProfileResponseDetails.ProfileID + "\n");
Console.WriteLine("Profile ID : " + responseCreateRecurringPaymentsProfileResponseType.CreateRecurringPaymentsProfileResponseDetails.ProfileID + "\n");
}
// # Error Values
else
{
List <ErrorType> errorMessages = responseCreateRecurringPaymentsProfileResponseType.Errors;
foreach (ErrorType error in errorMessages)
{
logger.Debug("API Error Message : " + error.LongMessage);
Console.WriteLine("API Error Message : " + error.LongMessage + "\n");
}
}
}
}
// # Exception log
catch (System.Exception ex)
{
// Log the exception message
logger.Debug("Error Message : " + ex.Message);
Console.WriteLine("Error Message : " + ex.Message);
}
return(responseCreateRecurringPaymentsProfileResponseType);
}
private void populateRequest(CreateRecurringPaymentsProfileRequestType request)
{
CurrencyCodeType currency = (CurrencyCodeType)
Enum.Parse(typeof(CurrencyCodeType), "USD");
// Set EC-Token or Credit card requestDetails
CreateRecurringPaymentsProfileRequestDetailsType profileDetails = new CreateRecurringPaymentsProfileRequestDetailsType();
request.CreateRecurringPaymentsProfileRequestDetails = profileDetails;
if (token.Value != "")
{
profileDetails.Token = token.Value;
}
else if (creditCardNumber.Value != "" && cvv.Value != "")
{
CreditCardDetailsType cc = new CreditCardDetailsType();
cc.CreditCardNumber = creditCardNumber.Value;
cc.CVV2 = cvv.Value;
cc.ExpMonth = Int32.Parse(expMonth.SelectedValue);
cc.ExpYear = Int32.Parse(expYear.SelectedValue);
profileDetails.CreditCard = cc;
}
// Populate Recurring Payments Profile Details
RecurringPaymentsProfileDetailsType rpProfileDetails =
new RecurringPaymentsProfileDetailsType(billingStartDate.Text);
profileDetails.RecurringPaymentsProfileDetails = rpProfileDetails;
if (subscriberName.Value != "")
{
rpProfileDetails.SubscriberName = subscriberName.Value;
}
if (shippingName.Value != "" && shippingStreet1.Value != "" && shippingCity.Value != "" &&
shippingState.Value != "" && shippingPostalCode.Value != "" && shippingCountry.Value != "")
{
AddressType shippingAddr = new AddressType();
shippingAddr.Name = shippingName.Value;
shippingAddr.Street1 = shippingStreet1.Value;
shippingAddr.CityName = shippingCity.Value;
shippingAddr.StateOrProvince = shippingCity.Value;
shippingAddr.CountryName = shippingCountry.Value;
shippingAddr.PostalCode = shippingPostalCode.Value;
if (shippingStreet2.Value != "")
{
shippingAddr.Street2 = shippingStreet2.Value;
}
if (shippingPhone.Value != "")
{
shippingAddr.Phone = shippingPhone.Value;
}
rpProfileDetails.SubscriberShippingAddress = shippingAddr;
}
// Populate schedule requestDetails
ScheduleDetailsType scheduleDetails = new ScheduleDetailsType();
profileDetails.ScheduleDetails = scheduleDetails;
if (profileDescription.Value != "")
{
scheduleDetails.Description = profileDescription.Value;
}
if (maxFailedPayments.Value != "")
{
scheduleDetails.MaxFailedPayments = Int32.Parse(maxFailedPayments.Value);
}
if (autoBillOutstandingAmount.SelectedIndex != 0)
{
scheduleDetails.AutoBillOutstandingAmount = (AutoBillType)
Enum.Parse(typeof(AutoBillType), autoBillOutstandingAmount.SelectedValue);
}
if (initialAmount.Value != "")
{
ActivationDetailsType activationDetails =
new ActivationDetailsType(new BasicAmountType(currency, initialAmount.Value));
if (failedInitialAmountAction.SelectedIndex != 0)
{
activationDetails.FailedInitialAmountAction = (FailedPaymentActionType)
Enum.Parse(typeof(FailedPaymentActionType), failedInitialAmountAction.SelectedValue);
}
scheduleDetails.ActivationDetails = activationDetails;
}
if (trialBillingAmount.Value != "" && trialBillingFrequency.Value != "" &&
trialBillingCycles.Value != "")
{
int frequency = Int32.Parse(trialBillingFrequency.Value);
BasicAmountType paymentAmount = new BasicAmountType(currency, trialBillingAmount.Value);
BillingPeriodType period = (BillingPeriodType)
Enum.Parse(typeof(BillingPeriodType), trialBillingPeriod.SelectedValue);
int numCycles = Int32.Parse(trialBillingCycles.Value);
BillingPeriodDetailsType trialPeriod = new BillingPeriodDetailsType(period, frequency, paymentAmount);
trialPeriod.TotalBillingCycles = numCycles;
if (trialShippingAmount.Value != "")
{
trialPeriod.ShippingAmount = new BasicAmountType(currency, trialShippingAmount.Value);
}
if (trialTaxAmount.Value != "")
{
trialPeriod.TaxAmount = new BasicAmountType(currency, trialTaxAmount.Value);
}
scheduleDetails.TrialPeriod = trialPeriod;
}
if (billingAmount.Value != "" && billingFrequency.Value != "" &&
totalBillingCycles.Value != "")
{
int frequency = Int32.Parse(billingFrequency.Value);
BasicAmountType paymentAmount = new BasicAmountType(currency, billingAmount.Value);
BillingPeriodType period = (BillingPeriodType)
Enum.Parse(typeof(BillingPeriodType), billingPeriod.SelectedValue);
int numCycles = Int32.Parse(totalBillingCycles.Value);
BillingPeriodDetailsType paymentPeriod = new BillingPeriodDetailsType(period, frequency, paymentAmount);
paymentPeriod.TotalBillingCycles = numCycles;
if (trialShippingAmount.Value != "")
{
paymentPeriod.ShippingAmount = new BasicAmountType(currency, shippingAmount.Value);
}
if (trialTaxAmount.Value != "")
{
paymentPeriod.TaxAmount = new BasicAmountType(currency, taxAmount.Value);
}
scheduleDetails.PaymentPeriod = paymentPeriod;
}
}
public static String MakeECRecurringProfile(ShoppingCart cart, int orderNumber, String payPalToken, String payerID, DateTime nextRecurringShipDate)
{
PayPalAPISoapBinding IPayPalRefund;
PayPalAPIAASoapBinding IPayPal;
PayPalController.GetPaypalRequirements(out IPayPalRefund, out IPayPal);
String result = String.Empty;
CreateRecurringPaymentsProfileReq ECRecurringRequest = new CreateRecurringPaymentsProfileReq();
CreateRecurringPaymentsProfileRequestType varECRequest = new CreateRecurringPaymentsProfileRequestType();
CreateRecurringPaymentsProfileRequestDetailsType varECRequestDetails = new CreateRecurringPaymentsProfileRequestDetailsType();
CreateRecurringPaymentsProfileResponseType ECRecurringResponse = new CreateRecurringPaymentsProfileResponseType();
//Re-Use the Internal Gateway Recurring Billing logic for calculating how much of the order is recurring
ShoppingCart cartRecur = new ShoppingCart(cart.ThisCustomer.SkinID, cart.ThisCustomer, CartTypeEnum.RecurringCart, orderNumber, false);
Decimal CartTotalRecur = Decimal.Round(cartRecur.Total(true), 2, MidpointRounding.AwayFromZero);
Decimal RecurringAmount = CartTotalRecur - CommonLogic.IIF(cartRecur.Coupon.CouponType == CouponTypeEnum.GiftCard, CommonLogic.IIF(CartTotalRecur < cartRecur.Coupon.DiscountAmount, CartTotalRecur, cartRecur.Coupon.DiscountAmount), 0);
DateIntervalTypeEnum ecRecurringIntervalType = cartRecur.CartItems[0].RecurringIntervalType; //We currently only support 1 interval per recurring order, so grabbing the first as a default should be safe
int ecRecurringInterval = cartRecur.CartItems[0].RecurringInterval;
BasicAmountType ecRecurringAmount = new BasicAmountType();
ecRecurringAmount.currencyID = (CurrencyCodeType)Enum.Parse(typeof(CurrencyCodeType), AppLogic.AppConfig("Localization.StoreCurrency"), true);
ecRecurringAmount.Value = RecurringAmount.ToString();
BillingPeriodDetailsType varECSchedulePaymentDetails = GetECRecurringPeriodDetails(ecRecurringIntervalType, ecRecurringInterval);
varECSchedulePaymentDetails.Amount = ecRecurringAmount;
varECSchedulePaymentDetails.TotalBillingCyclesSpecified = false;
ScheduleDetailsType varECSchedule = new ScheduleDetailsType();
//Need a better description, but it must match the one sent in StartEC
varECSchedule.Description = "Recurring order created on " + System.DateTime.Now.ToShortDateString() + " from " + AppLogic.AppConfig("StoreName");
varECSchedule.MaxFailedPayments = 0; //Cancel the order if a recurrence fails
varECSchedule.MaxFailedPaymentsSpecified = true;
varECSchedule.AutoBillOutstandingAmount = AutoBillType.NoAutoBill;
varECSchedule.AutoBillOutstandingAmountSpecified = true;
varECSchedule.PaymentPeriod = varECSchedulePaymentDetails;
RecurringPaymentsProfileDetailsType varECProfileDetails = new RecurringPaymentsProfileDetailsType();
varECProfileDetails.SubscriberName = cart.ThisCustomer.FirstName + " " + cart.ThisCustomer.LastName;
varECProfileDetails.BillingStartDate = nextRecurringShipDate;
varECRequestDetails.ScheduleDetails = varECSchedule;
varECRequestDetails.Token = payPalToken;
varECRequestDetails.RecurringPaymentsProfileDetails = varECProfileDetails;
if (cart.IsAllDownloadComponents())
{
PaymentDetailsItemType varECPaymentDetails = new PaymentDetailsItemType();
varECPaymentDetails.ItemCategory = ItemCategoryType.Digital;
varECPaymentDetails.ItemCategorySpecified = true;
List <PaymentDetailsItemType> ECPaymentDetailsList = new List <PaymentDetailsItemType>();
ECPaymentDetailsList.Add(varECPaymentDetails);
varECRequestDetails.PaymentDetailsItem = ECPaymentDetailsList.ToArray();
}
varECRequest.Version = API_VER;
varECRequest.CreateRecurringPaymentsProfileRequestDetails = varECRequestDetails;
ECRecurringRequest.CreateRecurringPaymentsProfileRequest = varECRequest;
ECRecurringResponse = IPayPal.CreateRecurringPaymentsProfile(ECRecurringRequest);
if (ECRecurringResponse.Ack.ToString().StartsWith("success", StringComparison.InvariantCultureIgnoreCase))
{
result = AppLogic.ro_OK;
}
else
{
if (ECRecurringResponse.Errors != null)
{
bool first = true;
for (int ix = 0; ix < ECRecurringResponse.Errors.Length; ix++)
{
if (!first)
{
result += ", ";
}
result += ECRecurringResponse.Errors[ix].LongMessage;
first = false;
}
}
}
//Log the transaction
OrderTransactionCollection ecRecurringOrderTransaction = new OrderTransactionCollection(orderNumber);
ecRecurringOrderTransaction.AddTransaction("PayPal Express Checkout Recurring Profile Creation",
ECRecurringRequest.ToString(),
result,
payerID, //PNREF = payerID
(ECRecurringResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID == null ? "No ProfileID provided" : ECRecurringResponse.CreateRecurringPaymentsProfileResponseDetails.ProfileID), //Code = ProfileID
AppLogic.ro_PMPayPalExpress,
null,
RecurringAmount);
return(result);
}
private void populateRequest(CreateRecurringPaymentsProfileRequestType request)
{
CurrencyCodeType currency = (CurrencyCodeType)
Enum.Parse(typeof(CurrencyCodeType), "USD");
// Set EC-Token or Credit card requestDetails
CreateRecurringPaymentsProfileRequestDetailsType profileDetails = new CreateRecurringPaymentsProfileRequestDetailsType();
request.CreateRecurringPaymentsProfileRequestDetails = profileDetails;
// A timestamped token, the value of which was returned in the response to the first call to SetExpressCheckout. You can also use the token returned in the SetCustomerBillingAgreement response. Either this token or a credit card number is required. If you include both token and credit card number, the token is used and credit card number is ignored Call CreateRecurringPaymentsProfile once for each billing agreement included in SetExpressCheckout request and use the same token for each call. Each CreateRecurringPaymentsProfile request creates a single recurring payments profile.
// Note: Tokens expire after approximately 3 hours.
if (token.Value != string.Empty)
{
profileDetails.Token = token.Value;
}
// Credit card information for recurring payments using direct payments. Either a token or a credit card number is required. If you include both token and credit card number, the token is used and credit card number is ignored.
else if (creditCardNumber.Value != string.Empty && cvv.Value != string.Empty)
{
CreditCardDetailsType cc = new CreditCardDetailsType();
// (Required) Credit card number.
cc.CreditCardNumber = creditCardNumber.Value;
// Card Verification Value, version 2. Your Merchant Account settings determine whether this field is required. To comply with credit card processing regulations, you must not store this value after a transaction has been completed.
cc.CVV2 = cvv.Value;
// (Required) Credit card expiration month.
cc.ExpMonth = Convert.ToInt32(expMonth.SelectedValue);
// (Required) Credit card expiration year.
cc.ExpYear = Convert.ToInt32(expYear.SelectedValue);
profileDetails.CreditCard = cc;
}
// Populate Recurring Payments Profile Details
RecurringPaymentsProfileDetailsType rpProfileDetails =
new RecurringPaymentsProfileDetailsType(billingStartDate.Text);
profileDetails.RecurringPaymentsProfileDetails = rpProfileDetails;
// (Optional) Full name of the person receiving the product or service paid for by the recurring payment. If not present, the name in the buyer's PayPal account is used.
if (subscriberName.Value != string.Empty)
{
rpProfileDetails.SubscriberName = subscriberName.Value;
}
// (Optional) The subscriber's shipping address associated with this profile, if applicable. If not specified, the ship-to address from buyer's PayPal account is used.
if (shippingName.Value != string.Empty && shippingStreet1.Value != string.Empty && shippingCity.Value != string.Empty &&
shippingState.Value != string.Empty && shippingPostalCode.Value != string.Empty && shippingCountry.Value != string.Empty)
{
AddressType shippingAddr = new AddressType();
// Person's name associated with this shipping address. It is required if using a shipping address.
shippingAddr.Name = shippingName.Value;
// First street address. It is required if using a shipping address.
shippingAddr.Street1 = shippingStreet1.Value;
// Name of city. It is required if using a shipping address.
shippingAddr.CityName = shippingCity.Value;
// State or province. It is required if using a shipping address.
shippingAddr.StateOrProvince = shippingState.Value;
// Country code. It is required if using a shipping address.
shippingAddr.CountryName = shippingCountry.Value;
// U.S. ZIP code or other country-specific postal code. It is required if using a U.S. shipping address; may be required for other countries.
shippingAddr.PostalCode = shippingPostalCode.Value;
// (Optional) Second street address.
if (shippingStreet2.Value != string.Empty)
{
shippingAddr.Street2 = shippingStreet2.Value;
}
// (Optional) Phone number.
if (shippingPhone.Value != string.Empty)
{
shippingAddr.Phone = shippingPhone.Value;
}
rpProfileDetails.SubscriberShippingAddress = shippingAddr;
}
// (Required) Describes the recurring payments schedule, including the regular payment period, whether there is a trial period, and the number of payments that can fail before a profile is suspended.
ScheduleDetailsType scheduleDetails = new ScheduleDetailsType();
// (Required) Description of the recurring payment.
// Note: You must ensure that this field matches the corresponding billing agreement description included in the SetExpressCheckout request.
if (profileDescription.Value != string.Empty)
{
scheduleDetails.Description = profileDescription.Value;
}
// (Optional) Number of scheduled payments that can fail before the profile is automatically suspended. An IPN message is sent to the merchant when the specified number of failed payments is reached.
if (maxFailedPayments.Value != string.Empty)
{
scheduleDetails.MaxFailedPayments = Convert.ToInt32(maxFailedPayments.Value);
}
// (Optional) Indicates whether you would like PayPal to automatically bill the outstanding balance amount in the next billing cycle. The outstanding balance is the total amount of any previously failed scheduled payments that have yet to be successfully paid. It is one of the following values:
// * NoAutoBill – PayPal does not automatically bill the outstanding balance.
// * AddToNextBilling – PayPal automatically bills the outstanding balance.
if (autoBillOutstandingAmount.SelectedIndex != 0)
{
scheduleDetails.AutoBillOutstandingAmount = (AutoBillType)
Enum.Parse(typeof(AutoBillType), autoBillOutstandingAmount.SelectedValue);
}
// (Optional) Information about activating a profile, such as whether there is an initial non-recurring payment amount immediately due upon profile creation and how to override a pending profile PayPal suspends when the initial payment amount fails.
if (initialAmount.Value != string.Empty)
{
// (Optional) Initial non-recurring payment amount due immediately upon profile creation. Use an initial amount for enrolment or set-up fees.
// Note: All amounts included in the request must have the same currency.
ActivationDetailsType activationDetails =
new ActivationDetailsType(new BasicAmountType(currency, initialAmount.Value));
// (Optional) Action you can specify when a payment fails. It is one of the following values:
// * ContinueOnFailure – By default, PayPal suspends the pending profile in the event that the initial payment amount fails. You can override this default behavior by setting this field to ContinueOnFailure. Then, if the initial payment amount fails, PayPal adds the failed payment amount to the outstanding balance for this recurring payment profile.
// When you specify ContinueOnFailure, a success code is returned to you in the CreateRecurringPaymentsProfile response and the recurring payments profile is activated for scheduled billing immediately. You should check your IPN messages or PayPal account for updates of the payment status.
// * CancelOnFailure – If this field is not set or you set it to CancelOnFailure, PayPal creates the recurring payment profile, but places it into a pending status until the initial payment completes. If the initial payment clears, PayPal notifies you by IPN that the pending profile has been activated. If the payment fails, PayPal notifies you by IPN that the pending profile has been canceled.
if (failedInitialAmountAction.SelectedIndex != 0)
{
activationDetails.FailedInitialAmountAction = (FailedPaymentActionType)
Enum.Parse(typeof(FailedPaymentActionType), failedInitialAmountAction.SelectedValue);
}
scheduleDetails.ActivationDetails = activationDetails;
}
// (Optional) Trial period for this schedule.
if (trialBillingAmount.Value != string.Empty && trialBillingFrequency.Value != string.Empty &&
trialBillingCycles.Value != string.Empty)
{
// Number of billing periods that make up one billing cycle;
// required if you specify an optional trial period.
// The combination of billing frequency and billing period must be
// less than or equal to one year. For example, if the billing cycle is Month,
// the maximum value for billing frequency is 12. Similarly,
// if the billing cycle is Week, the maximum value for billing frequency is 52.
// Note:
// If the billing period is SemiMonth, the billing frequency must be 1.
int frequency = Convert.ToInt32(trialBillingFrequency.Value);
//Billing amount for each billing cycle during this payment period;
//required if you specify an optional trial period.
//This amount does not include shipping and tax amounts.
//Note:
//All amounts in the CreateRecurringPaymentsProfile request must have
//the same currency.
//Character length and limitations:
//Value is a positive number which cannot exceed $10,000 USD in any currency.
//It includes no currency symbol.
//It must have 2 decimal places, the decimal separator must be a period (.),
//and the optional thousands separator must be a comma (,).
BasicAmountType paymentAmount = new BasicAmountType(currency, trialBillingAmount.Value);
//Unit for billing during this subscription period;
//required if you specify an optional trial period.
//It is one of the following values: [Day, Week, SemiMonth, Month, Year]
//For SemiMonth, billing is done on the 1st and 15th of each month.
//Note:
//The combination of BillingPeriod and BillingFrequency cannot exceed one year.
BillingPeriodType period = (BillingPeriodType)
Enum.Parse(typeof(BillingPeriodType), trialBillingPeriod.SelectedValue);
//Number of billing periods that make up one billing cycle;
//required if you specify an optional trial period.
//The combination of billing frequency and billing period must be
//less than or equal to one year. For example, if the billing cycle is Month,
//the maximum value for billing frequency is 12. Similarly,
//if the billing cycle is Week, the maximum value for billing frequency is 52.
//Note:
//If the billing period is SemiMonth, the billing frequency must be 1.
int numCycles = Convert.ToInt32(trialBillingCycles.Value);
BillingPeriodDetailsType trialPeriod = new BillingPeriodDetailsType(period, frequency, paymentAmount);
trialPeriod.TotalBillingCycles = numCycles;
//(Optional) Shipping amount for each billing cycle during this payment period.
//Note:
//All amounts in the request must have the same currency.
if (trialShippingAmount.Value != string.Empty)
{
trialPeriod.ShippingAmount = new BasicAmountType(currency, trialShippingAmount.Value);
}
//(Optional) Tax amount for each billing cycle during this payment period.
//Note:
//All amounts in the request must have the same currency.
//Character length and limitations:
//Value is a positive number which cannot exceed $10,000 USD in any currency.
//It includes no currency symbol. It must have 2 decimal places,
//the decimal separator must be a period (.), and the optional
//thousands separator must be a comma (,).
if (trialTaxAmount.Value != string.Empty)
{
trialPeriod.TaxAmount = new BasicAmountType(currency, trialTaxAmount.Value);
}
scheduleDetails.TrialPeriod = trialPeriod;
}
// (Required) Regular payment period for this schedule.
if (billingAmount.Value != string.Empty && billingFrequency.Value != string.Empty &&
totalBillingCycles.Value != string.Empty)
{
// Number of billing periods that make up one billing cycle;
// required if you specify an optional trial period.
// The combination of billing frequency and billing period must be
// less than or equal to one year. For example, if the billing cycle is Month,
// the maximum value for billing frequency is 12. Similarly,
// if the billing cycle is Week, the maximum value for billing frequency is 52.
// Note:
// If the billing period is SemiMonth, the billing frequency must be 1.
int frequency = Convert.ToInt32(billingFrequency.Value);
//Billing amount for each billing cycle during this payment period;
//required if you specify an optional trial period.
//This amount does not include shipping and tax amounts.
//Note:
//All amounts in the CreateRecurringPaymentsProfile request must have
//the same currency.
//Character length and limitations:
//Value is a positive number which cannot exceed $10,000 USD in any currency.
//It includes no currency symbol.
//It must have 2 decimal places, the decimal separator must be a period (.),
//and the optional thousands separator must be a comma (,).
BasicAmountType paymentAmount = new BasicAmountType(currency, billingAmount.Value);
BillingPeriodType period = (BillingPeriodType)
Enum.Parse(typeof(BillingPeriodType), billingPeriod.SelectedValue);
//Number of billing periods that make up one billing cycle;
//required if you specify an optional trial period.
//The combination of billing frequency and billing period must be
//less than or equal to one year. For example, if the billing cycle is Month,
//the maximum value for billing frequency is 12. Similarly,
//if the billing cycle is Week, the maximum value for billing frequency is 52.
//Note:
//If the billing period is SemiMonth, the billing frequency must be 1.
int numCycles = Convert.ToInt32(totalBillingCycles.Value);
//Unit for billing during this subscription period;
//required if you specify an optional trial period.
//It is one of the following values: [Day, Week, SemiMonth, Month, Year]
//For SemiMonth, billing is done on the 1st and 15th of each month.
//Note:
//The combination of BillingPeriod and BillingFrequency cannot exceed one year.
BillingPeriodDetailsType paymentPeriod = new BillingPeriodDetailsType(period, frequency, paymentAmount);
paymentPeriod.TotalBillingCycles = numCycles;
//(Optional) Shipping amount for each billing cycle during this payment period.
//Note:
//All amounts in the request must have the same currency.
if (trialShippingAmount.Value != string.Empty)
{
paymentPeriod.ShippingAmount = new BasicAmountType(currency, shippingAmount.Value);
}
//(Optional) Tax amount for each billing cycle during this payment period.
//Note:
//All amounts in the request must have the same currency.
//Character length and limitations:
//Value is a positive number which cannot exceed $10,000 USD in any currency.
//It includes no currency symbol. It must have 2 decimal places,
//the decimal separator must be a period (.), and the optional
//thousands separator must be a comma (,).
if (trialTaxAmount.Value != string.Empty)
{
paymentPeriod.TaxAmount = new BasicAmountType(currency, taxAmount.Value);
}
scheduleDetails.PaymentPeriod = paymentPeriod;
}
profileDetails.ScheduleDetails = scheduleDetails;
}
