User Data in Payments with Non-Integrated Bank Cards

Tags: v9preview1 v9

In the API V9Preview1, a new nullable field CustomData limited to 5000 characters has been added to the class CardPaymentItemAdditionalData. Filling the fields of CardPaymentItemAdditionalData now occurs through a constructor with 2 arguments:

public CardPaymentItemAdditionalData([CanBeNull] string cardNumber, [CanBeNull] string customData = null)
{...}

A small example of filling and reading CustomData:

/// <summary>
/// Adding an externally processed card payment.
/// </summary>
private void AddCardExternalProcessedPayment()
{
    const bool isProcessed = true;
    var order = PluginContext.Operations.GetOrders().Last(o => o.Status == OrderStatus.New);
    var paymentType = PluginContext.Operations.GetPaymentTypes().First(x => x.Kind == PaymentTypeKind.Card && x.Name.ToUpper() == "VISA");
    var additionalData = new CardPaymentItemAdditionalData("123456", "0987654321");
    var credentials = PluginContext.Operations.GetDefaultCredentials();
    var paymentItem = PluginContext.Operations.AddExternalPaymentItem(order.ResultSum / 2, isProcessed, additionalData, null, paymentType, order, credentials);

    MessageBox.Show(((CardPaymentItemAdditionalData)paymentItem.AdditionalData).CustomData);
}