---
title: "Void a barcode"
method: POST
path: "/v1/Barcode/{gd_barcode_id}/status/{gd_barcode_status}"
tags: ["Barcode"]
---

# Void a barcode

`POST /v1/Barcode/{gd_barcode_id}/status/{gd_barcode_status}`

## Request

- Base URL: `https://partners.dev.nextestate.com/GDCPartners/API`
- URL: `https://partners.dev.nextestate.com/GDCPartners/API/v1/Barcode/{gd_barcode_id}/status/{gd_barcode_status}`
- Auth: none declared. Required headers: `x-gdn-programnumber`, `x-gdn-channeltype`, `x-gdn-devicetype`, `x-gdn-messageid`, `x-gdn-encryptiontype`, `x-gdn-signature`, `x-gdn-ipaddress`, `x-gdn-timestamp`

Void a barcode by barcode number.

## Path parameters

- `gd_barcode_id` string, required
- `gd_barcode_status` string, required

## Headers

- `x-gdn-programnumber` string, required
- `x-gdn-channeltype` string, required
- `x-gdn-longitude` string
- `x-gdn-latitude` string
- `x-gdn-devicetype` string, required
- `x-gdn-deviceid` string
- `x-gdn-messageid` string, required
- `x-gdn-sessionid` string
- `x-gdn-encryptiontype` string, required
- `x-gdn-signature` string, required
- `x-gdn-ipaddress` string, required
- `x-gdn-timestamp` string, required

## Response `200`

OK

- BarcodeStatusUpdateResponse: BarcodeStatusUpdateResponse
  - `gd_barcode_id` string: Barcode number or Barcode link code based on the type of barcode generated
  - `gd_barcode_status` integer: 1 = New,2 = Pending,3 = Consumed,4 = Voided,5 = Expired,6 = Cancelled,7 = Declined
  - `partner_transaction_reference` string: partner_transaction_reference TransactionReference of the partner if the partner passes this information
  - `gd_transaction_reference` string: gd_transaction_reference Unique reference for this transaction generated by Gd
  - `gd_response_code` integer: gd_response_code
  - `gd_response_message` string: gd_response_message Custom text describing the success or failure of the API.
  - `gd_response_date` string, date-time: gd_response_date Response date time in UTC

---

[API](https://skmtc.dev/greendot/apis/cash-deposits-and-payments.md) - [All operations](https://skmtc.dev/greendot/apis/cash-deposits-and-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/greendot/apis/cash-deposits-and-payments/revisions/9908e094c93e?raw)