# Issuance

Welcome to the Annex Cloud Issuance API documentation, where loyalty and seamless customer experiences converge. This comprehensive guide provides everything you need to seamlessly integrate with our transaction/issuance API. Whether you’re an experienced developer leveraging loyalty data or a business owner enhancing customer satisfaction, this documentation will guide you through the world of loyalty-driven transactions.

The Order API lacks the ability to handle specific dynamic attributes during order creation. To address this limitation, we have introduced the Issuance API, designed to store and process orders. Unlike the Order API, this new API does not include predefined calculations and mirrors the functionalities of the Order API.

Clients who would like to leverage more dynamic order attributes using the Issuance API will need to first calculate the points for spending and determine how members earn points. They will then send this value to our API, which should then accept it and grant the corresponding benefits based on the received payload.

## Create a new issuance

 - [POST /issuance- create new issuance](https://annexcloud.redocly.app/loyalty/loyalty/issuance/postissuance.md): Use the POST method in the Issuance API to create a new order initiated by a member within the loyalty program. Each order is assigned a unique ID and encompasses essential order details, including the member initiating the order, the total amount of the order, the order placement timestamp, any discounts applied to the order, the shipping timestamp, and other pertinent information. The remaining fields in the request body are detailed below.

## Issuance Creation for Non-Purchase Transactions

 - [POST /issuance- Issuance creation for non purchase transaction](https://annexcloud.redocly.app/loyalty/loyalty/issuance/postissuancecreationfornonpurchasetransactions.md): Use the POST method in the Issuance API to create a new Non-Purchase Transactions within the loyalty program. Each order has a unique ID and includes essential details like the member, total amount, order timestamp, discounts, shipping timestamp, and other relevant info. Include mandatory fields like order ID and user ID parameters.

## Updated Issuance return

 - [PATCH /issuance- Updated Issuance return](https://annexcloud.redocly.app/loyalty/loyalty/issuance/patchupdatedissuancereturn.md): Use a PATCH method for updating the status of an existing order, enabling actions such as RETURN, PARTIAL RETURN. Utilize the PATCH method within the Issuance API to modify the order status of a shipment to return status as specified in the input parameter.

## Update the Issuance details

 - [PUT /issuance- Update the Issuance details](https://annexcloud.redocly.app/loyalty/loyalty/issuance/putupdateissuancedetails.md): Use PUT method to edit and update the existing transactional details.

## Update the transaction as Partial Ship

 - [PATCH /issuance- Update the transaction as Partial Ship](https://annexcloud.redocly.app/loyalty/loyalty/issuance/patchupdatetransactionaspartialship.md): Use the PATCH method in the Issuance API to modify the order status of a shipment to "Partial Ship." Orders have the option to be adjusted to Partial Ship status, with all other fields specified in the request body.

## Update transaction as Partial Cancel

 - [PATCH /issuance- Update transaction as Partial Cancel](https://annexcloud.redocly.app/loyalty/loyalty/issuance/patchupdatetransactionaspartialcancel.md): Use the PATCH method in the Issuance API to modify the order status of a shipment to "Partial Cancel." Orders have the option to be adjusted to Partial Cancel status, with all other fields specified in the request body.

## Use Issuance details filter

 - [POST /issuancedetails/{{memberId}}](https://annexcloud.redocly.app/loyalty/loyalty/issuance/postissuancedetailsfilter.md): Use the POST method to filter the issuance details.

## Update the transaction as Full cancel

 - [PATCH /issuance- Update the transaction as Full Cancel](https://annexcloud.redocly.app/loyalty/loyalty/issuance/patchupdatetransactionasfullcancel.md): Use the PATCH method in the Issuance API to modify the order status of a shipment to "Full Cancel". Orders have the option to be updated as "Full Cancel", while all other fields are specified in the request body.

## Update the transaction as Full ship

 - [PATCH /issuance- Update the transaction as Full Ship](https://annexcloud.redocly.app/loyalty/loyalty/issuance/patchupdatetransactionasfullship.md): Use the PATCH method in the Issuance API to update the order status of a shipment to Full Ship. Orders can be updated as Ship. All other fields are listed in the request body.