RArailz
Refunds

POST /refunds

Changed on

Posts an individual refund for a business.

Request

  • Base URL
    https://api.railz.ai
  • Auth
    HTTP bearer

Request body

Example request

{
  "connection": {
    "businessName": "Railz",
    "serviceName": "xero"
  },
  "data": {
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    },
    "totalAmount": 150.5,
    "memo": "Services rendered.",
    "customerRef": "145",
    "accountRef": "130",
    "date": "2021-03-09",
    "invoiceRef": "503",
    "currency": "CAD",
    "lines": [
      {
        "inventoryRef": "32",
        "taxRef": "2"
      }
    ]
  }
}

Response

pushCommunicationIdstring required
requestedOnstring date-time required
status'success' | 'failed' | 'pending' required
businessNamestring required
serviceName'xero' | 'quickbooks' | 'freshbooks' required

Example response

{
  "pushCommunicationId": "60473b57f0cdd1683ca71f60",
  "requestedOn": "2021-03-09T08:15:22.035Z",
  "status": "pending",
  "businessName": "Railz",
  "serviceName": "xero",
  "data": {
    "passThrough": {
      "CustomField": [
        {
          "DefinitionId": "1",
          "StringValue": "my custom value",
          "Name": "Field One"
        }
      ]
    },
    "totalAmount": 150.5,
    "memo": "Services rendered.",
    "customerRef": "145",
    "accountRef": "130",
    "date": "2021-03-09",
    "invoiceRef": "503",
    "currency": "CAD",
    "lines": [
      {
        "inventoryRef": "32",
        "taxRef": "2"
      }
    ]
  }
}

Changes

  • 5cdfae3fa1faRevision changes
    • breaking

      the response's property format changed from uuid to no format for status

    • info

      added the new optional request property /

    • info

      the / request property format was generalized from uuid to no format

    • info

      added the optional property ///// to the response with the status