Gift Card activation and buyer_payment_instrument_ids

I need some help with buyer_payment_instrument_ids. What should/can I use for buyer_payment_instrument_ids when activating a gift card using createGiftCardActivity()?

I’ve seen in a similar topic that one can use “cash” for a buyer_payment_instrument_id. What does “cash” mean when used in this context? Also, are there other non-id string options for this field?

What is the buyer using to tender the gift card? Like how is the buyer of the gift card paying for the card? Is it through a payment from some other processor or is the gift card being preloaded and they’re getting the card for free? :slightly_smiling_face:

They get the gift card for free. It’s pre-loaded.

Okay, great! You can use pre-loaded for the value if you’d like. :slightly_smiling_face:

Thank you!

Can you point me to somewhere in the docs that describes the options. E.g. “pre-loaded”, “cash”, etc.

Yes, here is the link to our documentation. Also this is what I use:

    "gift_card_activity": {
      "location_id": "{{location_id}}",
      "type": "ACTIVATE",
      "activate_activity_details": {
        "amount_money": {
          "amount": 2500,
          "currency": "USD"
        "buyer_payment_instrument_ids": [
      "gift_card_gan": "{{gift_card_gan}}",
      "gift_card_id": "{{gift_card_id}}"
    "idempotency_key": "{{$guid}}"