/// <summary>
/// Sends a CancelNotification message to a store.
/// </summary>
/// <param name="requestUuid">The request UUID.</param>
/// <returns>The message identifier.</returns>
public long CancelNotification(Guid requestUuid)
{
var header = CreateMessageHeader(Protocols.StoreNotification, MessageTypes.StoreNotification.CancelNotification);
var cancelNotification = new CancelNotification()
{
RequestUuid = requestUuid.ToUuid()
};
return(Session.SendMessage(header, cancelNotification));
}
/// <summary>
/// Handles the cancel notification.
/// </summary>
/// <param name="header">The header.</param>
/// <param name="request">The request.</param>
protected override void HandleCancelNotification(MessageHeader header, CancelNotification request)
{
base.HandleCancelNotification(header, request);
var message = _requests.FirstOrDefault(x => x.Request.Uuid.EqualsIgnoreCase(request.RequestUuid));
if (message == null)
{
// TODO: Should this be an error?
}
else
{
_requests.Remove(message);
_headers.Remove(message.Request.Uuid);
}
}
public Invoice CancelInvoice(string id)
{
var apiContext = GetApiContext();
var invoiceId = id;
var cancelNotification = new CancelNotification
{
subject = "Payment Canceled",
note = "The payment has been canceled.",
send_to_merchant = true,
send_to_payer = true
};
var createdInvoice = GetInvoiceInfo(id);
createdInvoice.Cancel(GetApiContext(), cancelNotification);
return(createdInvoice);
}
protected override void RunSample()
{
// ### Api Context
// Pass in a `APIContext` object to authenticate
// the call and to send a unique request id
// (that ensures idempotency). The SDK generates
// a request id if you do not pass one explicitly.
// See [Configuration.cs](/Source/Configuration.html) to know more about APIContext.
var apiContext = Configuration.GetAPIContext();
// ### Create an invoice
// For demonstration purposes, we will create a new invoice for this sample.
var invoice = new Invoice()
{
// #### Merchant Information
// Information about the merchant who is sending the invoice.
merchant_info = new MerchantInfo()
{
email = "*****@*****.**",
first_name = "Dennis",
last_name = "Doctor",
business_name = "Medical Professionals, LLC",
phone = new Phone()
{
country_code = "001",
national_number = "4083741550"
},
address = new InvoiceAddress()
{
line1 = "1234 Main St.",
city = "Portland",
state = "OR",
postal_code = "97217",
country_code = "US"
}
},
// #### Billing Information
// Email address of invoice recipient and optional billing information.
// > Note: PayPal currently only allows one recipient.
billing_info = new List <BillingInfo>()
{
new BillingInfo()
{
// **(Required)** Email address of the invoice recipient.
email = "*****@*****.**"
}
},
// #### Invoice Items
// List of items to be included in the invoice.
// > Note: 100 max per invoice.
items = new List <InvoiceItem>()
{
new InvoiceItem()
{
name = "Sutures",
quantity = 100,
unit_price = new Currency()
{
currency = "USD",
value = "5"
}
}
},
// #### Invoice Note
// Note to the payer. Maximum length is 4000 characters.
note = "Medical Invoice 16 Jul, 2013 PST",
// #### Payment Term
// **(Optional)** Specifies the payment deadline for the invoice.
// > Note: Either `term_type` or `due_date` can be sent, **but not both.**
payment_term = new PaymentTerm()
{
term_type = "NET_30"
},
// #### Shipping Information
// Shipping information for entities to whom items are being shipped.
shipping_info = new ShippingInfo()
{
first_name = "Sally",
last_name = "Patient",
business_name = "Not applicable",
address = new InvoiceAddress()
{
line1 = "1234 Broad St.",
city = "Portland",
state = "OR",
postal_code = "97216",
country_code = "US"
}
}
};
// ^ Ignore workflow code segment
#region Track Workflow
this.flow.AddNewRequest("Create the invoice", invoice);
#endregion
// Create the invoice
var createdInvoice = invoice.Create(apiContext);
// ^ Ignore workflow code segment
#region Track Workflow
this.flow.RecordResponse(createdInvoice);
#endregion
// Setup the cancellation notice.
var cancelNotification = new CancelNotification
{
subject = "Payment Canceled",
note = "The payment has been canceled.",
send_to_merchant = true,
send_to_payer = true
};
// ^ Ignore workflow code segment
#region Track Workflow
this.flow.AddNewRequest("Send the cancellation notice", cancelNotification);
#endregion
createdInvoice.Cancel(apiContext, cancelNotification);
// ^ Ignore workflow code segment
#region Track Workflow
this.flow.RecordActionSuccess("Cancellation notice sent successfully.");
#endregion
// For more information, please visit [PayPal Developer REST API Reference](https://developer.paypal.com/docs/api/).
}
/// <summary>
/// Handles the CancelNotification message from a customer.
/// </summary>
/// <param name="header">The message header.</param>
/// <param name="request">The CancelNotification message.</param>
protected virtual void HandleCancelNotification(IMessageHeader header, CancelNotification request)
{
Notify(OnCancelNotification, header, request);
}
