Get Invoice Details

Retrieve an invoice's details to check its current status and payment history. Retrieving an invoice's details requires the unique invoice number assigned when the invoice was created.
If you need more information about the payment history, you can also use the transaction details API. For more information, see the Transaction Details API section in the
Transaction Search and Details API Developer Guide
.

Endpoints

Send your API request to one of these endpoints:
Test:
PUT https://
https://apitest.cybersource.com
/invoicing/v2/invoices/
{id}
Production:
PUT https://
https://api.cybersource.com
/invoicing/v2/invoices/
{id}
Production in India:
PUT https://api.in.cybersource.com/invoicing/v2/invoices/
{id}
The
{id}
 is the invoice number from the invoice creation response message.

Successful Response

A response contains this invoice information:
Response Fields to a Successful Request
Response Field
Description
submitTimeUtc
The date and time that the invoice was sent, in UTC format.
status
The invoice status. Possible values:
  • CANCELED
    : The invoice is cancelled.
  • CREATED
    : The invoice is created.
  • DRAFT
    : The invoice is drafted and not published.
  • PAID
    : The invoice is fully paid. The customer is notified that the payment is successful.
  • PARTIAL
    : The invoice is partially paid.
  • PENDING
    : Fraud management is reviewing the invoice and you must accept or reject the payment. The customer is also notified that the payment is processing. When you accept the payment, the invoice updates to the
    PAID
     status. If you reject the payment, the invoice updates to the
    SENT
     status.
    IMPORTANT
    This status is only retrievable for merchants with fraud management enabled.
  • SENT
    : The invoice is delivered to the customer.
customerInformation
 (field object)
The customer's information, such as name and email.
invoiceInformation
 (field object)
The
paymentLink
 field contains the direct URL to the invoice.
orderInformation
 (field object)
The itemized amount charged for the billed goods and services.
invoiceHistory
 (field object)
An array of invoice status changes and the date and time stamp of each invoice status changed.

Example: Get Invoice Details

REST Interactive Example: Get Invoice Details

Click this image to access the interactive code example for retrieving invoice details.

Figure:

Interactive Code
Image and link to the interactive code example for creating a new invoice.
Light Dark
Endpoint with an Invoice Number
1
GET://https://api.cybersource.com/2670
Request
1
{}
Response to a Successful Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
{"_links": {
    "self": {
      "href": "/v2/invoices/2670",
      "method": "GET"
    },
    "update": {
      "href": "/v2/invoices/2670",
      "method": "PUT"
    },
    "deliver": {
      "href": "/v2/invoices/2670/delivery",
      "method": "POST"
    },
    "cancel": {
      "href": "/v2/invoices/2670/cancelation",
      "method": "POST"
    }
  },
  "id": "2670",
  "submitTimeUtc": "2024-07-24T18:36:18.863175539Z",
  "status": "SENT",
  "customerInformation": {
    "name": "Tanya Lee",
    "email": "tanya.lee@my-email.world"
  },
  "processingInformation": {
    "requestPhone": false,
    "requestShipping": false
  },
  "invoiceInformation": {
    "invoiceNumber": "2670",
    "dueDate": "2019-07-11",
    "allowPartialPayments": false,
    "paymentLink": "https://businesscenter.cybersource.com/ebc2/invoicing/payInvoice/W447tdnINi5t5wu6QA0KUE2HYWY2rQQ0zXL5b5z6M50w4Ea9FFlcYrEmp09pFlzl?version=v2.1",
    "deliveryMode": "Email"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": 247.86,
      "currency": "USD",
      "balanceAmount": 247.86
    },
    "lineItems": [
      {
        "productSku": "P653727383",
        "productName": "First line item's name",
        "unitPrice": 12.05,
        "quantity": 20,
        "totalAmount": 247.86
      }
    ]
  },
  "invoiceHistory": [
    {
      "event": "SEND",
      "date": "2024-07-24T18:35:23.320Z"
    },
    {
      "event": "DRAFT",
      "date": "2024-07-24T18:35:22.960Z"
    }
  ]}