Developer Guide Menu

Level III Data Captures and Credits

To include Level III data in a capture or credit request:
  1. Authorize a payment card payment.
    CyberSource recommends that for Level III transactions you include the total order amount in the authorization request, even though it is not required. Doing so ensures that CyberSource uses your total order amount and that the capture or credit request total amount matches the original authorization total amount. The field to use in the authorization request is
    orderInformation.amountDetails.totalAmount
    .
  2. Capture the authorization.
    Include the following information in the capture request:
    • Level II and Level III data. See Processor Specific Information
    • Purchasing level field: the field name is
      processingInformation.purchaseLevel
      S. Set this field to
      3
      to indicate that the request includes Level III data.

    NOTE

    RBS WorldPay Atlanta does not require Level II data for credits.
  3. For all processors except CyberSource through VisaNet, verify the capture reply message.
    The reply message includes a field that indicates whether CyberSource sent the Level III information to the processor. The field name is
    orderInformation.invoiceDetails.level3TransmissionStatus
    . The possible values are:
    • True
      —the account is enabled for Level III transactions. The Level III data was included in the request to the processor.
    • False
      —the account is not enabled for Level III transactions. The Level III data was not included in the request to the processor.
    If your account is not enabled for Level III data or if you did not include the purchasing-level field in your request, CyberSource does not include the Level III data in the request sent to the processor.
  4. If necessary, credit the payment. Include the following information in the credit request:
    • Level II and Level III data. See Processor Specific Information
    • Purchasing-level field: the field name is
      processingInformation.purchaseLevel
      . Set this field to
      3
      to indicate that the request includes Level III data.

    NOTE

    OmniPay Direct does not require Level III data for credits. When you include Level III data in a credit request for OmniPay Direct, CyberSource does not pass the Level II data to OmniPay Direct.

    NOTE

    RBS WorldPay Atlanta does not require Level II data for credits.
  5. For all processors except CyberSource through VisaNet, verify the credit reply message.
    The reply message includes a field that indicates whether CyberSource sent the Level III information to the processor. The field name is
    orderInformation.invoiceDetails.level3TransmissionStatus
    . The possible values are:
    • True
      —the account is enabled for Level III transactions. The Level III data was included in the request to the processor.
    • False
      —the account is not enabled for Level III transactions. The Level III data was not included in the request to the processor.
    If your account is not enabled for Level III data or if you did not include the purchasing-level field in your request, CyberSource does not include the Level III data in the request sent to the processor.
Top