Refunds

Refunds are issued by Neon, based on the refund policy listed in your contract with us. Once a purchase is refunded, no further refunds (of any amount) can be issued.

Refunds can be requested in one of three ways:

• Users can request a refund directly via the refund link in their confirmation email or through the Neon Shop.
• If a user contacts you for a refund, you can reach out to your Neon Billing Support representative and request it on their behalf. Please include the order number in your request.
• You can use the Refund API (access may need to be requested).

Once we process the refund, we'll update your game by sending you a refund.processed event. (See Webhooks and Callbacks for more on how we handle events, and how you can set up a server to listen for them.) The event body includes the purchase ID of the purchase being refunded. You can use this event as a trigger to update your user's account however you choose (e.g. by removing the item from their account).

Refund types

When issuing or requesting a refund, you can either issue a total refund or a partial refund:

• Total refunds: A total refund is a refund for the entire purchase.
  • All items are considered “refunded” when a total refund is issued (purchase limits are reset, etc).
  • A total refund may not be for the full amount of the original purchase. You can optionally set a fee on a total refund, reducing the amount refunded to the user. These fees and charges will be imposed on the total amount of the purchase.
  • Only one total refund can be issued. A total refund cannot be issued if another refund has already been issued.
• Partial refunds: A partial refund is a refund for a subset of items within a purchase.
  • Only the items being refunded are considered refunded for purchase limits / inventory.
  • Partial refund amounts are calculated based on the item total of the items being refunded. Taxes are calculated as appropriate for the market (backed out or added on).
  • An arbitrary number of partial refunds can be issued, but items cannot be refunded beyond the original purchase amount (less any items already refunded).

To request a total refund, simply call the POST /refund API, optionally with a fee specified:

curl --request POST \
     --url https://api.neonpay.com/purchases/<purchase ID>/refund \
     --header 'X-API-KEY: <your API key>'
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "fee": 1234
}
'

(Note that if fee is left unspecified, we'll default to a fee of zero and refund the entire purchase amount.)

To request a partial refund, call the POST /refund API with a list of items to be refunded.

• First, call GET /purchases/{purchaseId} and inspect the items array for the items you'd like to refund. Note the id and refundableQuantity on each item.
• For each item you'd like to refund, construct an object with { itemId: <item.id>, quantity: <quantity> }.
• Pass in the array of items as items to the POST endpoint.

For example, consider the following purchase:

curl --request GET \
     --url https://api.neonpay.com/purchases/06f65af3-e18c-45ed-8268-9ebc9238d7ee
     --header 'X-API-KEY: <your API key>'
     --header 'accept: application/json'
     --header 'content-type: application/json'
{
  "id": "06f65af3-e18c-45ed-8268-9ebc9238d7ee",
  ...
  "items": [
    {
      "id": "72a51367-ef54-4e28-af67-403595055fca",
      "sku": "wood-sku",
      "name": "Wood Shield",
      "price": 199,
      "referencePrice": 199,
      "referenceCurrency": "USD",
      "quantity": 1,
      "refundableQuantity": 1
    },
    {
      "id": "1df53a38-585f-47f2-9247-5804cbc422e0",
      "sku": "iron-sku",
      "name": "Iron Shield",
      "price": 199,
      "referencePrice": 199,
      "referenceCurrency": "USD",
      "quantity": 2,
      "refundableQuantity": 2
    }
  ]
  ...
}

In order to request a refund of 1 unit of the Wood Shield and 1 unit of the Iron Shield, call the POST /refund API as follows:

curl --request POST \
     --url https://api.neonpay.com/purchases/<purchase ID>/refund \
     --header 'X-API-KEY: <your API key>'
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "items": [
    {
      "itemId": "72a51367-ef54-4e28-af67-403595055fca",
      "quantity": 1
    },
    {
      "itemId": "1df53a38-585f-47f2-9247-5804cbc422e0",
      "quantity": 1
    }
  ]
}
'