/// <summary> /// <b>Half.com only.</b> Retrieves a summary of pending or paid payments that Half.com created for the /// seller identified by the authentication token in the request. /// This call retrieves only /// payments that occurred within a particular pay period. /// <br/><br/> /// Each payment is for one /// order line item in one order. An order can contain order line items for /// multiple items from multiple sellers, but this call only retrieves payments that /// are relevant to one seller. The financial value of a payment is typically based on /// an amount that a buyer paid to Half.com for an order line item, with adjustments for /// shipping costs and Half.com's commission. /// <br/><br/> /// For most sellers, each month contains /// two pay periods: One from the 1st to the 15th of the month, and one from the 16th /// to the last day of the month. Sellers can refer to their account information on /// the Half.com site to determine their pay periods. (You cannot retrieve a seller's /// pay periods by using eBay API.) /// <br/><br/> /// When a buyer makes a purchase and an /// order is created, Half.com creates a payment for the seller and marks it as /// <b>Pending</b> in the seller's Half.com account. Within a certain number of days after /// the pay period ends, Half.com settles payments for that period and marks each /// completed payment as Paid. /// <br/><br/> /// See the Half.com Web site online help for more /// information about how payments are managed. /// </summary> /// /// <param name="PaymentStatus"> /// A filter to retrieve only items with the specified payment status (Paid or /// Pending). /// <b></b> /// <ul> /// <li><b>Pending payments</b> are payments that Half.com has created but /// that have not yet been sent to the seller's financial institution. Pending /// payments are typically available once a buyer pays for an order. /// As Half.com processes payments by using periodic batch jobs, the /// <b>GetSellerPayments</b> response might not include an order line item's payment for /// up to 20 minutes after the buyer has paid. /// You can retrieve pending /// payments for the current pay period. Pending payments that have not been /// settled yet can also be retrieved for previous pay periods. </li> /// <li><b>Paid payments</b> are payments that Half.com processed during previous pay /// periods. Paid payments might not appear in the seller's financial /// institution account balance until a certain number of days after the /// current pay period ends (see the Half.com online help for details). You /// can only retrieve paid payments for one previous pay period at a time.</li> /// </ul> /// </param> /// /// <param name="PaymentTimeFrom"> /// Time range filter that retrieves Half.com payments that were created within /// a single pay period. Sellers can refer to the Half.com site to determine /// their pay periods. <b>PaymentTimeFrom</b> is the earliest (oldest) time and /// <b>PaymentTimeTo</b> is the latest (most recent) time in the range. Half.com pay /// periods start and end at midnight Pacific time, but the time values are /// stored in the database in GMT (not Pacific time). See "Time Values" in the /// eBay Features Guide for information about converting between GMT and /// Pacific time. /// /// If you specify a <b>PaymentStatus</b> of <b>Pending</b>, add a buffer of one hour (or one /// day) to both ends of the time range to retrieve more data than you need, and /// then filter the results on the client side as needed. If any pending /// payments match the request, the response may include all payments since the /// beginning of the period. /// /// If you specify a <b>PaymentStatus</b> of <b>Paid</b>, the time range must contain one /// full pay period. That is, <b>PaymentTimeFrom</b> must be earlier or equal the /// start time of the pay period, and <b>PaymentTimeTo</b> must be later than or /// equal to the end time of the pay period. Otherwise, no paid payments are /// returned. For example, if the pay period starts on 2005-09-16 and ends on /// 2005-09-30, you could specify an earlier <b>PaymentTimeFrom</b> value of /// 2005-09-16T00:00:00.000Z and a later <b>PaymentTimeTo</b> value of /// 2005-10-01T12:00:00.000Z. /// /// If you specify a time range that covers two pay periods, only the payments /// from the most recent pay period are returned. The earliest time you can /// specify is 18 months ago. /// </param> /// /// <param name="PaymentTimeTo"> /// Time range filter that retrieves Half.com payments for a single pay /// period. See the description of <b>PaymentTimeTo</b> for details about using this /// time range filter. For paid payments, this value should be equal to or /// later than the end of the last day of the pay period, where the time is /// converted to GMT. For example, if the period ends on 2005-09-30, you could /// specify 2005-10-01T09:00:00.000Z, which is later than the end of the last /// day. /// </param> /// /// <param name="Pagination"> /// If many payments are available, you may need to call <b>GetSellerPayments</b> /// multiple times to retrieve all the data. Each result set is returned as a /// page of entries. Use this <b>Pagination</b> information to indicate the maximum /// number of entries to retrieve per page (i.e., per call), the page number /// to retrieve, and other data. /// </param> /// public SellerPaymentTypeCollection GetSellerPayments(RCSPaymentStatusCodeType PaymentStatus, DateTime PaymentTimeFrom, DateTime PaymentTimeTo, PaginationType Pagination) { this.PaymentStatus = PaymentStatus; this.PaymentTimeFrom = PaymentTimeFrom; this.PaymentTimeTo = PaymentTimeTo; this.Pagination = Pagination; Execute(); return(ApiResponse.SellerPayment); }
/// <summary> /// Enables a seller to update the payment details, the shipping details, /// and the status of an order. /// </summary> /// /// <param name="ItemID"> /// Unique identifier for an eBay listing. A listing can have multiple order line items, but only one <b>ItemID</b>. An <b>ItemID</b> can be paired up with a corresponding <b>TransactionID</b> and used as an input filter for <b>ReviseCheckoutStatus</b>. Unless an <b>OrderLineItemID</b> is used to identify a single line item order, or the <b>OrderID</b> is used to identify a single or multiple line item (Combined Invoice) order, the <b>ItemID</b>/<b>TransactionID</b> pair must be specified. For a multiple line item (Combined Invoice) order, <b>OrderID</b> should be used. If <b>OrderID</b> or <b>OrderLineItemID</b> are specified, the <b>ItemID</b>/<b>TransactionID</b> pair is ignored if present in the same request. /// <br/> /// <br/> /// It is also possible to identify a single line item order with a /// <b>ItemID</b>/<b>BuyerID</b> combination, but this is not the most ideal approach since an error is returned if there are multiple order line items for that combination. /// <br/> /// </param> /// /// <param name="TransactionID"> /// Unique identifier for an eBay order line item. An order /// line item is created once there is a commitment from a buyer to purchase /// an item. Since an auction listing can only have one order line item /// during the duration of the listing, the <b>TransactionID</b> for /// auction listings is always <code>0</code>. Along with its corresponding <b>ItemID</b>, a /// <b>TransactionID</b> is used and referenced during an order checkout flow and /// after checkout has been completed. The <b>ItemID</b>/<b>TransactionID</b> pair can be /// used as an input filter for <b>ReviseCheckoutStatus</b>. /// /// Unless an <b>OrderLineItemID</b> is used to identify a single line item order, /// or the <b>OrderID</b> is used to identify a single or multiple line item /// (Combined Invoice) order, the <b>ItemID</b>/<b>TransactionID</b> pair must be /// specified. For a multiple line item (Combined Invoice) order, <b>OrderID</b> /// must be used. If <b>OrderID</b> or <b>OrderLineItemID</b> are specified, the /// <b>ItemID</b>/<b>TransactionID</b> pair is ignored if present in the same request. /// /// </param> /// /// <param name="OrderID"> /// A unique identifier that identifies a single line item or multiple line /// item (Combined Invoice) order. /// /// For a single line item order, the <b>OrderID</b> value is identical to the /// <b>OrderLineItemID</b> value that is generated upon creation of the order line /// item. For a Combined Invoice order, the <b>OrderID</b> value is created by eBay /// when the buyer or seller (sharing multiple, common order line items) /// combines multiple order line items into a Combined Invoice order through /// the eBay site. A Combined Invoice order can also be created by the /// seller through the <b>AddOrder</b> call. The <b>OrderID</b> can be used as an input /// filter for <b>ReviseCheckoutStatus</b>. /// /// <b>OrderID</b> overrides an <b>OrderLineItemID</b> or <b>ItemID</b>/<b>TransactionID</b> pair if /// these fields are also specified in the same request. /// </param> /// /// <param name="AmountPaid"> /// The total amount paid by the buyer. For a US eBay Motors item, /// <b>AmountPaid</b> is the total amount paid by the buyer for the deposit. /// <b>AmountPaid</b> is optional if <b>CheckoutStatus</b> is Incomplete and required if it /// is Complete. /// </param> /// /// <param name="PaymentMethodUsed"> /// Payment method used by the buyer. This field is required if <b> /// CheckoutStatus</b> is Complete and the payment method is a trusted /// payment method other than PayPal. See eBay's /// <a href="http://pages.ebay.com/help/policies/accepted-payments-policy.html">Accepted Payments Policy</a>. /// If the payment method is PayPal, this field should not be used since only PayPal can set this field's /// value to "PayPal". ReviseCheckoutStatus cannot be used for a non-trusted /// payment method. /// <b>Note:</b>Required or allowed payment methods vary by site and category. /// </param> /// /// <param name="CheckoutStatus"> /// This field is included and its value is set to <code>Complete</code> if the seller is using the <b>ReviseCheckoutStatus</b> call to mark the order as 'Paid' by including the <b>PaymentStatus</b> field and setting its value to <code>Paid</code>. /// </param> /// /// <param name="ShippingService"> /// The shipping service selected by the buyer from among the shipping services offered by the seller (such as UPS Ground). For a list of valid values, call GeteBayDetails with DetailName set to ShippingServiceDetails. The ShippingServiceDetails.ValidForSellingFlow flag must also be present. Otherwise, that particular shipping service option is no longer valid and cannot be offered to buyers through a listing. <br/><br/> <span class="tablenote"> <strong>Note:</strong> <strong>ReviseCheckoutStatus</strong> is not available for the Global Shipping program; specifying <code>InternationalPriorityShipping</code> as a value for this field will produce an error. </span> /// </param> /// /// <param name="ShippingIncludedInTax"> /// An indicator of whether shipping costs were included in the /// taxable amount. /// </param> /// /// <param name="CheckoutMethod"> /// This field is deprecated. /// </param> /// /// <param name="InsuranceType"> /// This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance. /// </param> /// /// <param name="PaymentStatus"> /// This field is used to mark the order as paid or awaiting payment in My eBay. If you specify 'Paid', My eBay displays an icon for each line item in the order to indicate that the order status is Paid. If you specify 'Pending', this indicates that the order is awaiting payment (some applications may use 'Pending' when the buyer has paid, but the funds have not yet been sent to the seller's financial institution). /// /// /// <b>ReviseCheckoutStatus</b> cannot be used to update payment and checkout /// status for a non-trusted payment method. See eBay's <a href=" /// http://pages.ebay.com/help/policies/accepted-payments-policy.html"> /// Accepted Payments Policy</a> for more information on trusted /// payment methods. If the payment method is PayPal, this field should not /// be used since PayPal automatically set this field's value to "Paid" upon /// receiving the buyer's payment. /// </param> /// /// <param name="AdjustmentAmount"> /// Discount or charge agreed to by the buyer and seller. A positive value /// indicates that the amount is an extra charge being paid to the seller by /// the buyer. A negative value indicates that the amount is a discount given /// to the buyer by the seller. /// </param> /// /// <param name="ShippingAddress"> /// For internal use only. Do not use. /// </param> /// /// <param name="BuyerID"> /// eBay user ID for the order's buyer. A single line item order can /// actually be identified by a <b>BuyerID</b>/<b>ItemID</b> pair, but this approach is /// not recommended since an error is returned if there are multiple /// order line items for that combination. <b>BuyerID</b> is ignored if any other valid /// filter or filter combination is used in the same request. /// </param> /// /// <param name="ShippingInsuranceCost"> /// This field is no longer applicable as it is not longer possible for a seller to offer a buyer shipping insurance. /// </param> /// /// <param name="SalesTax"> /// The sales tax amount for the order. This field should be used if sales tax /// was applied to the order. /// </param> /// /// <param name="ShippingCost"> /// Amount of money paid for shipping. /// </param> /// /// <param name="EncryptedID"> /// Not supported. /// </param> /// /// <param name="ExternalTransaction"> /// This container is used if payment for the order occurred off of eBay, and the seller wants to pass in the external payment reference ID. /// </param> /// /// <param name="MultipleSellerPaymentID"> /// Not supported. /// </param> /// /// <param name="CODCost"> /// This dollar value indicates the money due from the buyer upon delivery of the item. /// /// This field should only be specified in the <b>ReviseCheckoutStatus</b> request if 'COD' (cash-on-delivery) was the payment method selected by the buyer and it is included as the <b>PaymentMethodUsed</b> value in the same request. /// </param> /// /// <param name="OrderLineItemID"> /// <b>OrderLineItemID</b> is a unique identifier for an eBay order line item and /// is based upon the concatenation of <b>ItemID</b> and <b>TransactionID</b>, with a /// hyphen in between these two IDs. For a single line item order, the /// <b>OrderLineItemID</b> value can be passed into the <b>OrderID</b> field to revise the /// checkout status of the order. /// /// Unless an <b>ItemID</b>/<b>TransactionID</b> pair is used to identify a single line item order, or the <b>OrderID</b> is used to identify a single or multiple line item (Combined Invoice) order, the <b>OrderLineItemID</b> must be specified. For a multiple line item (Combined Invoice) order, <b>OrderID</b> should be used. If <b>OrderLineItemID</b> is specified, the <b>ItemID</b>/<b>TransactionID</b> pair are ignored if present in the same request. /// </param> /// public void ReviseCheckoutStatus(string ItemID, string TransactionID, string OrderID, AmountType AmountPaid, BuyerPaymentMethodCodeType PaymentMethodUsed, CompleteStatusCodeType CheckoutStatus, string ShippingService, bool ShippingIncludedInTax, CheckoutMethodCodeType CheckoutMethod, InsuranceSelectedCodeType InsuranceType, RCSPaymentStatusCodeType PaymentStatus, AmountType AdjustmentAmount, AddressType ShippingAddress, string BuyerID, AmountType ShippingInsuranceCost, AmountType SalesTax, AmountType ShippingCost, string EncryptedID, ExternalTransactionType ExternalTransaction, string MultipleSellerPaymentID, AmountType CODCost, string OrderLineItemID) { this.ItemID = ItemID; this.TransactionID = TransactionID; this.OrderID = OrderID; this.AmountPaid = AmountPaid; this.PaymentMethodUsed = PaymentMethodUsed; this.CheckoutStatus = CheckoutStatus; this.ShippingService = ShippingService; this.ShippingIncludedInTax = ShippingIncludedInTax; this.CheckoutMethod = CheckoutMethod; this.InsuranceType = InsuranceType; this.PaymentStatus = PaymentStatus; this.AdjustmentAmount = AdjustmentAmount; this.ShippingAddress = ShippingAddress; this.BuyerID = BuyerID; this.ShippingInsuranceCost = ShippingInsuranceCost; this.SalesTax = SalesTax; this.ShippingCost = ShippingCost; this.EncryptedID = EncryptedID; this.ExternalTransaction = ExternalTransaction; this.MultipleSellerPaymentID = MultipleSellerPaymentID; this.CODCost = CODCost; this.OrderLineItemID = OrderLineItemID; Execute(); }
/// <summary> /// Enables a seller can use this call to update the payment details, the shipping details, /// and the status of an order. /// </summary> /// /// <param name="ItemID"> /// Unique identifier for an eBay item listing. A listing can have multiple /// order line items (transactions), but only one <b>ItemID</b>. An <b>ItemID</b> can be /// paired up with a corresponding <b>TransactionID</b> and used as an input filter /// for <b>ReviseCheckoutStatus</b>. /// /// Unless an <b>OrderLineItemID</b> is used to identify a single line item order, /// or the <b>OrderID</b> is used to identify a single or multiple line item /// (Combined Invoice) order, the <b>ItemID</b>/<b>TransactionID</b> pair must be /// specified. For a multiple line item (Combined Invoice) order, <b>OrderID</b> /// should be used. If <b>OrderID</b> or <b>OrderLineItemID</b> are specified, the /// <b>ItemID</b>/<b>TransactionID</b> pair is ignored if present in the same request. /// <br /> /// <br /> /// It is also possible to identify a single line item order with a /// <b>ItemID</b>/<b>BuyerID</b> combination, but this is not the most ideal /// approach since an error is returned if there are multiple /// order line items for that combination. /// </param> /// /// <param name="TransactionID"> /// Unique identifier for an eBay order line item (transaction). An order /// line item is created once there is a commitment from a buyer to purchase /// an item. Since an auction listing can only have one order line item /// during the duration of the listing, the <b>TransactionID</b> for /// auction listings is always 0. Along with its corresponding <b>ItemID</b>, a /// <b>TransactionID</b> is used and referenced during an order checkout flow and /// after checkout has been completed. The <b>ItemID</b>/<b>TransactionID</b> pair can be /// used as an input filter for <b>ReviseCheckoutStatus</b>. /// /// Unless an <b>OrderLineItemID</b> is used to identify a single line item order, /// or the <b>OrderID</b> is used to identify a single or multiple line item /// (Combined Invoice) order, the <b>ItemID</b>/<b>TransactionID</b> pair must be /// specified. For a multiple line item (Combined Invoice) order, <b>OrderID</b> /// must be used. If <b>OrderID</b> or <b>OrderLineItemID</b> are specified, the /// <b>ItemID</b>/<b>TransactionID</b> pair is ignored if present in the same request. /// </param> /// /// <param name="OrderID"> /// A unique identifier that identifies a single line item or multiple line /// item (Combined Invoice) order. /// /// For a single line item order, the <b>OrderID</b> value is identical to the /// <b>OrderLineItemID</b> value that is generated upon creation of the order line /// item. For a Combined Invoice order, the <b>OrderID</b> value is created by eBay /// when the buyer or seller (sharing multiple, common order line items) /// combines multiple order line items into a Combined Invoice order through /// the eBay site. A Combined Invoice order can also be created by the /// seller through the <b>AddOrder</b> call. The <b>OrderID</b> can be used as an input /// filter for <b>ReviseCheckoutStatus</b>. /// /// <b>OrderID</b> overrides an <b>OrderLineItemID</b> or <b>ItemID</b>/<b>TransactionID</b> pair if /// these fields are also specified in the same request. /// </param> /// /// <param name="AmountPaid"> /// The total amount paid by the buyer. For a motor vehicle purchased on eBay Motors, /// <b>AmountPaid</b> is the total amount paid by the buyer for the deposit. /// <b>AmountPaid</b> is optional if <b>CheckoutStatus</b> is Incomplete and required if it /// is Complete. /// </param> /// /// <param name="PaymentMethodUsed"> /// Payment method used by the buyer. This field is required if <b> /// CheckoutStatus</b> is Complete and the payment method is a trusted /// payment method other than PayPal. See eBay's /// <a href="http://pages.ebay.com/help/policies/accepted-payments-policy.html">Accepted Payments Policy</a>. /// If the payment method is PayPal, this field should not be used since only PayPal can set this field's /// value to "PayPal". ReviseCheckoutStatus cannot be used for a non-trusted /// payment method. /// <b>Note:</b>Required or allowed payment methods vary by site and category. /// </param> /// /// <param name="CheckoutStatus"> /// The current checkout status of the order. Often, the seller or /// application will mark this value as 'Complete' if payment has been made. /// </param> /// /// <param name="ShippingService"> /// The shipping service selected by the buyer from among the shipping services /// offered by the seller (such as UPS Ground). For a list of valid values, call /// GeteBayDetails with DetailName set to ShippingServiceDetails. The /// ShippingServiceDetails.ValidForSellingFlow flag must also be present. /// Otherwise, that particular shipping service option is no longer valid and /// cannot be offered to buyers through a listing. /// <br/><br/> /// <span class="tablenote"> /// <strong>Note:</strong> <strong>ReviseCheckoutStatus</strong> is not available for the Global Shipping program; specifying InternationalPriorityShipping as a value for this field will produce an error. /// </span> /// </param> /// /// <param name="ShippingIncludedInTax"> /// An indicator of whether shipping costs were included in the /// taxable amount. . /// </param> /// /// <param name="CheckoutMethod"> /// </param> /// /// <param name="InsuranceType"> /// Enumeration value that indicates whether shipping insurance was offered to and /// selected by the buyer. /// </param> /// /// <param name="PaymentStatus"> /// This field is used to mark the order as paid or awaiting payment in My eBay. If you specify 'Paid', My eBay displays an icon for each line item in the order to indicate that the order status is Paid. If you specify 'Pending', this indicates that the order is awaiting payment (some applications may use 'Pending' when the buyer has paid, but the funds have not yet been sent to the seller's financial institution). /// /// /// <b>ReviseCheckoutStatus</b> cannot be used to update payment and checkout /// status for a non-trusted payment method. See eBay's <a href=" /// http://pages.ebay.com/help/policies/accepted-payments-policy.html"> /// Accepted Payments Policy</a> for more information on trusted /// payment methods. If the payment method is PayPal, this field should not /// be used since PayPal automatically set this field's value to "Paid" upon /// receiving the buyer's payment. /// </param> /// /// <param name="AdjustmentAmount"> /// Discount or charge agreed to by the buyer and seller. A positive value /// indicates that the amount is an extra charge being paid to the seller by /// the buyer. A negative value indicates that the amount is a discount given /// to the buyer by the seller. /// </param> /// /// <param name="ShippingAddress"> /// For internal use. /// </param> /// /// <param name="BuyerID"> /// eBay user ID for the order's buyer. A single line item order can /// actually be identified by a <b>BuyerID</b>/<b>ItemID</b> pair, but this approach is /// not recommended since an error is returned if there are multiple /// order line items for that combination. <b>BuyerID</b> is ignored if any other valid /// filter or filter combination is used in the same request. /// </param> /// /// <param name="ShippingInsuranceCost"> /// The amount of money paid for shipping insurance. /// </param> /// /// <param name="SalesTax"> /// The sales tax amount for the order. This field should be used if sales tax /// was applied to the order. /// </param> /// /// <param name="ShippingCost"> /// The amount of money paid for shipping. /// </param> /// /// <param name="EncryptedID"> /// Not supported. /// </param> /// /// <param name="ExternalTransaction"> /// This container is used to identify the electronic payment (other than Paypal) of an order. /// </param> /// /// <param name="MultipleSellerPaymentID"> /// Not supported. /// </param> /// /// <param name="CODCost"> /// This dollar value indicates the money due from the buyer upon delivery of the item. /// /// This field should only be specified in the <b>ReviseCheckoutStatus</b> /// request if 'COD' (cash-on-delivery) was the payment method selected by the buyer /// and it is included as the <b>PaymentMethodUsed</b> value in the same /// request. /// </param> /// /// <param name="OrderLineItemID"> /// <b>OrderLineItemID</b> is a unique identifier for an eBay order line item and /// is based upon the concatenation of <b>ItemID</b> and <b>TransactionID</b>, with a /// hyphen in between these two IDs. For a single line item order, the /// <b>OrderLineItemID</b> value can be passed into the <b>OrderID</b> field to revise the /// checkout status of the order. /// /// Unless an <b>ItemID</b>/<b>TransactionID</b> pair is used to identify a single line /// item order, or the <b>OrderID</b> is used to identify a single or multiple line /// item (Combined Invoice) order, the <b>OrderLineItemID</b> must be specified. /// For a multiple line item (Combined Invoice) order, <b>OrderID</b> should be /// used. If <b>OrderLineItemID</b> is specified, the <b>ItemID</b>/<b>TransactionID</b> pair are /// ignored if present in the same request. /// </param> /// public void ReviseCheckoutStatus(string ItemID, string TransactionID, string OrderID, AmountType AmountPaid, BuyerPaymentMethodCodeType PaymentMethodUsed, CompleteStatusCodeType CheckoutStatus, string ShippingService, bool ShippingIncludedInTax, CheckoutMethodCodeType CheckoutMethod, InsuranceSelectedCodeType InsuranceType, RCSPaymentStatusCodeType PaymentStatus, AmountType AdjustmentAmount, AddressType ShippingAddress, string BuyerID, AmountType ShippingInsuranceCost, AmountType SalesTax, AmountType ShippingCost, string EncryptedID, ExternalTransactionType ExternalTransaction, string MultipleSellerPaymentID, AmountType CODCost, string OrderLineItemID) { this.ItemID = ItemID; this.TransactionID = TransactionID; this.OrderID = OrderID; this.AmountPaid = AmountPaid; this.PaymentMethodUsed = PaymentMethodUsed; this.CheckoutStatus = CheckoutStatus; this.ShippingService = ShippingService; this.ShippingIncludedInTax = ShippingIncludedInTax; this.CheckoutMethod = CheckoutMethod; this.InsuranceType = InsuranceType; this.PaymentStatus = PaymentStatus; this.AdjustmentAmount = AdjustmentAmount; this.ShippingAddress = ShippingAddress; this.BuyerID = BuyerID; this.ShippingInsuranceCost = ShippingInsuranceCost; this.SalesTax = SalesTax; this.ShippingCost = ShippingCost; this.EncryptedID = EncryptedID; this.ExternalTransaction = ExternalTransaction; this.MultipleSellerPaymentID = MultipleSellerPaymentID; this.CODCost = CODCost; this.OrderLineItemID = OrderLineItemID; Execute(); }
/// <summary> /// <b>Half.com only.</b> Retrieves a summary of pending or paid payments that Half.com created for the /// seller identified by the authentication token in the request. Only retrieves /// payments that occurred within a particular pay period. Each payment is for one /// order line item in one order. An order can contain order line items for /// multiple items from multiple sellers, but this call only retrieves payments that /// are relevant to one seller. The financial value of a payment is typically based on /// an amount that a buyer paid to Half.com for an order line item, with adjustments for /// shipping costs and Half.com's commission. For most sellers, each month contains /// two pay periods: One from the 1st to the 15th of the month, and one from the 16th /// to the last day of the month. Sellers can refer to their account information on /// the Half.com site to determine their pay periods. (You cannot retrieve a seller's /// pay periods by using eBay API.) When a buyer makes a purchase and an /// order is created, Half.com creates a payment for the seller and marks it as /// Pending in the seller's Half.com account. Within a certain number of days after /// the pay period ends, Half.com settles payments for that period and marks each /// completed payment as Paid. See the Half.com Web site online help for more /// information about how payments are managed. /// </summary> /// /// <param name="PaymentStatus"> /// Filter to retrieve only items with the specified payment status (Paid or /// Pending). "Pending payments" are payments that Half.com has created but /// that have not yet been sent to the seller's financial institution. Pending /// payments are typically available once a buyer pays for an order. As /// Half.com processes payments by using periodic batch jobs, the /// GetSellerPayments response might not include an order line item's payment for /// up to 20 minutes after the buyer has paid. You can retrieve pending /// payments for the current pay period. Pending payments that have not been /// settled yet can also be retrieved for previous pay periods. "Paid /// payments" are payments that Half.com processed during previous pay /// periods. Paid payments might not appear in the seller's financial /// institution account balance until a certain number of days after the /// current pay period ends (see the Half.com online help for details). You /// can only retrieve paid payments for one previous pay period at a time. /// </param> /// /// <param name="PaymentTimeFrom"> /// Time range filter that retrieves Half.com payments that were created within /// a single pay period. Sellers can refer to the Half.com site to determine /// their pay periods. PaymentTimeFrom is the earliest (oldest) time and /// PaymentTimeTo is the latest (most recent) time in the range. Half.com pay /// periods start and end at midnight Pacific time, but the time values are /// stored in the database in GMT (not Pacific time). See "Time Values" in the /// eBay Features Guide for information about converting between GMT and /// Pacific time. /// /// If you specify a PaymentStatus of Pending, add a buffer of one hour (or one /// day) to both ends of the time range to retrieve more data than you need, and /// then filter the results on the client side as needed. If any pending /// payments match the request, the response may include all payments since the /// beginning of the period. /// /// If you specify a PaymentStatus of Paid, the time range must contain one /// full pay period. That is, PaymentTimeFrom must be earlier or equal the /// start time of the pay period, and PaymentTimeTo must be later than or /// equal to the end time of the pay period. Otherwise, no paid payments are /// returned. For example, if the pay period starts on 2005-09-16 and ends on /// 2005-09-30, you could specify an earlier PaymentTimeFrom value of /// 2005-09-16T00:00:00.000Z and a later PaymentTimeTo value of /// 2005-10-01T12:00:00.000Z. /// /// If you specify a time range that covers two pay periods, only the payments /// from the most recent pay period are returned. The earliest time you can /// specify is 18 months ago. /// </param> /// /// <param name="PaymentTimeTo"> /// Time range filter that retrieves Half.com payments for a single pay /// period. See the description of PaymentTimeTo for details about using this /// time range filter. For paid payments, this value should be equal to or /// later than the end of the last day of the pay period, where the time is /// converted to GMT. For example, if the period ends on 2005-09-30, you could /// specify 2005-10-01T09:00:00.000Z, which is later than the end of the last /// day. /// </param> /// /// <param name="Pagination"> /// If many payments are available, you may need to call GetSellerPayments /// multiple times to retrieve all the data. Each result set is returned as a /// page of entries. Use this Pagination information to indicate the maximum /// number of entries to retrieve per page (i.e., per call), the page number /// to retrieve, and other data. /// </param> /// public SellerPaymentTypeCollection GetSellerPayments(RCSPaymentStatusCodeType PaymentStatus, DateTime PaymentTimeFrom, DateTime PaymentTimeTo, PaginationType Pagination) { this.PaymentStatus = PaymentStatus; this.PaymentTimeFrom = PaymentTimeFrom; this.PaymentTimeTo = PaymentTimeTo; this.Pagination = Pagination; Execute(); return ApiResponse.SellerPayment; }