On This Page

The Request Element

The
<Request>
 element contains information about a payment transaction.
<Request RequestID=CDATA>
      (TransactionReferenceNumber)
      (MerchantReferenceNumber)
      (TransactionStatus)
      (Amount)
      (CurrencyCode)
      (PaymentStatus)
</Request>
This table describes the attributes of the
<Request>
 element.
Attributes of the
<Request>
 Element
Attribute Name
Description
RequestID
Unique identifier generated by
Cybersource
 for the transaction.
  • Data type: Numeric
  • Data length: 26
This table describes the child elements of the
<Request>
 element.
Child Elements of the
<Request>
 Element
Element Name
Description
TransactionReferenceNumber
Reference number that you use to reconcile your
Cybersource
 reports with your processor reports. This field corresponds to the
<service>
_reconciliationID
 (Simple Order API) and to the
<service>_
trans_ref_no
 (SCMP API) response fields.
  • Data type: Alphanumeric
  • Data length: 60
MerchantReferenceNumber
Merchant-generated order reference or tracking number.
  • Data type: Alphanumeric
  • Data length: 50
TransactionStatus
One-word description of the result of the transaction request.
  • Data type: Alphanumeric
  • Data length: 50
Amount
Amount of the transaction.
CurrencyCode
ISO currency code used for the transaction. See ISO Standard Country Codes.
  • Data type: Alphanumeric
  • Data length: 5
PaymentStatus
One-word description of the current status of the transaction. Possible values:
  • BATCH_ERROR
  • BATCH_RESET
  • BATCHED
  • CANCELED_REVERS
  • CANCELLED
  • DENIED
  • FAILED
  • PENDING
  • REFUNDED
  • REVERSED
  • TRXN_ERROR
  • VOIDED
Specifications:
  • Data type: Alphanumeric
  • Data length: 50
This
<Request>
 element includes a single example transaction in the
PENDING
 state.
<Request RequestID="1580782287420174065733">
      <TransactionReferenceNumber>5533830406</TransactionReferenceNumber>
      <MerchantReferenceNumber>1158078228539</MerchantReferenceNumber>
      <TransactionStatus>SOK</TransactionStatus>
      <Amount>25.00</Amount>
      <CurrencyCode>USD</CurrencyCode>
      <PaymentStatus>PENDING</PaymentStatus>
</Request>
RELATED TO THIS PAGE