JUjustifi
Refunds

Update a Refund

Update the refund metadata.

patch/refunds/{id}

Request

Path parameters

idstring uuid required

Headers

Idempotency-Keystring uuid required

a string to identify your request (we recommend using a generated uuid, but you may use any unique string) see Idempotent Requests

Authorizationstring required

the access_token value returned from the JustiFi oauth/token endpoint (be sure to append Bearer before the token)

Request body

metadataobject

any useful information you'd like to store alongside this refund; when you update metadata, any previous metadata will be overwritten

Response

Refund update was successful

idstring uuid

the object id, also found in the data object

typestring

the object type, or array of objects

page_infounknown

Example response

{
  "id": "prefix_xyz (same as id of data object)",
  "type": "refund",
  "data": {
    "id": "re_xyz",
    "payment_id": "py_xyz",
    "amount": 100,
    "description": "customer canceled their order",
    "reason": "duplicate",
    "status": "succeeded",
    "metadata": {},
    "returned_fees": [
      {
        "id": "rtfee_xyz",
        "payment_fee_id": "pyfee_abc",
        "type": "processing_fee",
        "returned_amount": 175,
        "original_amount": 350,
        "currency": "usd",
        "remaining_amount": 175
      }
    ],
    "created_at": "2021-01-01T12:00:00Z",
    "updated_at": "2021-01-01T12:00:00Z"
  }
}

Changes

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