gift_cards

Fix a gift card's balance by a signed amount, in the currency's minor units (cents; whole yen for zero-decimal currencies), with your reason: an entry of kind adjust, and gift_card.adjusted. It can't go below zero (409 gift_card_short)

post/gift_cards/{id}/adjust

Request

  • Base URL: https://daybag.io/api/v1
  • URL: https://daybag.io/api/v1/gift_cards/{id}/adjust
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

amount_centsinteger required

More than zero adds to the balance, less takes off it

reasonstring required

Why, kept on the entry

Response

Success

idstring required
org_idstring required
codestring required

12 characters of Crockford base32, as made: guests give it as they book (bookings.create's gift_card_code), in any case, spaced or not

amount_centsinteger required

What it was worth when made, in the currency's minor units (cents; whole yen for zero-decimal currencies)

currencystring required

ISO 4217, lowercase: the org's when it was made

for_namestring required

Who it's for, as given; may be empty

for_emailstring required

Who it's for: emailed the code when it was made

from_namestring required

Who it's from: the buyer, or your business for one you issued

from_emailstring required
messagestring required

The buyer's message to who it's for, up to 300 characters; may be empty

issued_by'purchase' | 'business' nullable required

purchase: bought on your booking page; business: issued by you (gift_cards_issue)

checkout_session_idstring nullable required

A bought card's Stripe Checkout, on your account

payment_intent_idstring nullable required

A bought card's Stripe payment, on your account

created_atstring required

ISO 8601 timestamp (UTC)

balanceinteger required

What's on it: the sum of its entries, in the currency's minor units (cents; whole yen for zero-decimal currencies). Gift cards never expire

availableinteger required

What it can spend now: the balance less the parts of live holds that take it once they're confirmed, in the currency's minor units (cents; whole yen for zero-decimal currencies)

Changes

No recorded changes to this operation across all 1 revision of this API.