ACEB.com

Search the ACEB gift-card catalog

Search in-stock gift cards by free-text query, category, or country. selectedValue for carts must lie within a returned faceValues range and step, in its currency.

Read an ACEB cart

Read a cart by id: items, quantities, face values.

Create an ACEB cart

Create a cart with the given items and get a shareable cartUrl for the human. Use only when the user has explicitly asked to add items to a cart — recommending a product alone does not authorize this. Modifies no orders and initiates no payment.

Update quantity or face value of a cart item

Change the quantity and/or selectedValue of one cart line, addressed by productIndex (its position in the cart items array).

Remove an item from a cart

Remove one cart line by productIndex. Use only when the user explicitly asked for the removal.

Create a crypto checkout for a cart

Create a hosted CRYPTO payment session (Bitcoin, Ethereum, USDC and more) for a cart and return paymentUrl for the human to pay on — this tool never takes payment itself. Use only on explicit checkout intent. Gift cards are delivered to the given email after payment. Crypto-only: if the user wants SEPA or another method, give them the cartUrl instead of calling this. Retrying with an unchanged cart returns the same session.

Check an ACEB order

Order status for orders created through these tools. 'pending' = awaiting payment (paymentUrl included); 'completed' = gift cards delivered to the order email. Never returns redeem codes.