Redeem Gift Instance

post

https://api.getkivly.com/api/v1/gift-cards/instances/redeem

Consume card balance (amount_cents) or uses. Omitting amount_cents consumes the full monetary balance. Acts as the authenticated owner. Reconcile timeouts before retrying to avoid spending twice.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

200Successful Response

401Authentication credentials were missing, invalid, or expired.

403The authenticated integration does not have access to this resource.

404Resource not found in the integration location.

409Action conflicts with the current resource state; reconcile before retrying.

422Validation Error

429Too many requests. Retry after the period indicated by the API.

500Unexpected server error.

503Shared integration limiter unavailable. Retry after the indicated delay.