Как в CyberSource использовать гибкий токен кредитной карты с платежным API?

Хорошо, спасибо @rhldr за указание на эту конкретную документацию.

Ответ находится на этой странице https://developer.cybersource.com/api/developer-guides/dita-flex/SAFlexibleToken/FlexMicroform/GetStarted.html в разделе «Использование токена».

Примечание. В некоторых других документах (не уверен, почему у них так много вариантов документов), например Вот этот, это вообще не упоминается.

См. раздел RESTPaymentAPI. Его необходимо предоставить в виде поля customerId.

"paymentInformation": {
    "customer": {
        "customerId": "7500BB199B4270EFE05340588D0AFCAD"
    }
}

Вот минимальный пример того, как это можно реализовать на стороне API.

var cybersourceRestApi = require('cybersource-rest-client');
var configuration = require('./cybersource/config.js');

var configObject = new configuration();
var instance = new cybersourceRestApi.PaymentsApi(configObject);

var clientReferenceInformation = new cybersourceRestApi.Ptsv2paymentsClientReferenceInformation();
clientReferenceInformation.code = 'test_payment';

var processingInformation = new cybersourceRestApi.Ptsv2paymentsProcessingInformation();
processingInformation.commerceIndicator = 'internet';

var amountDetails = new cybersourceRestApi.Ptsv2paymentsOrderInformationAmountDetails();
amountDetails.totalAmount = "100.00";
amountDetails.currency = 'USD';

var orderInformation = new cybersourceRestApi.Ptsv2paymentsOrderInformation();
orderInformation.amountDetails = amountDetails;


var paymentInformation = new cybersourceRestApi.Ptsv2paymentsPaymentInformation();

// THIS IS THE IMPORTANT BIT
var customer = new cybersourceRestApi.Ptsv2paymentsPaymentInformationCustomer()
customer.customerId = token
paymentInformation.customer = customer

var request = new cybersourceRestApi.CreatePaymentRequest();
request.clientReferenceInformation = clientReferenceInformation;
request.processingInformation = processingInformation;
request.orderInformation = orderInformation;
request.paymentInformation = paymentInformation;

if (!authoriseOnly) {
    request.processingInformation.capture = true;
}

Код на основе образцов REST узлов CyberSource: https://github.com/CyberSource/cybersource-rest-samples-node

Больше информации. Как только вы знаете, где искать, это на самом деле объясняется в нескольких местах.

Например, перейдите к https://developer.cybersource.com/cybs-dev-api-ref/index.html#payments-process-a-payment, разверните «ОПИСАНИЕ ПОЛЯ ЗАПРОСА» внизу и перейдите к

customer         
    .. customerId    

Unique identifier for the customer's card and billing information.

When you use Payment Tokenization or Recurring Billing and you include this value in your request, many of the fields that are normally required for an authorization or credit become optional.

NOTE When you use Payment Tokenization or Recurring Billing, the value for the Customer ID is actually the Cybersource payment token for a customer. This token stores information such as the consumer’s card number so it can be applied towards bill payments, recurring payments, or one-time payments. By using this token in a payment API request, the merchant doesn't need to pass in data such as the card number or expiration date in the request itself.

See "Payment Tokenization," page 222, and "Recurring Billing," page 225.