Skip to main content
Refund Invoice
curl --request POST \
  --url https://api.revolv3.com/api/Invoices/{invoiceId}/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '
{
  "amount": 5,
  "includeRawProcessorResponse": false
}
'
{
  "invoice": {
    "invoiceId": 2,
    "parentInvoiceId": 1,
    "customerId": 1,
    "merchantInvoiceRefId": "f89325a1-5d8b-4897-a615-f9d93b09f221",
    "paymentMethod": {
      "paymentMethodId": 1,
      "billingAddressId": 1,
      "billingFirstName": "John",
      "billingLastName": "Doe",
      "merchantPaymentMethodRefId": null,
      "billingAddress": {
        "addressId": 1,
        "addressLine1": "1 Default Street",
        "addressLine2": null,
        "city": "Los Angeles",
        "state": "CA",
        "postalCode": "90210",
        "phoneNumber": null,
        "email": null,
        "country": "US"
      },
      "paymentMethodAchDetails": null,
      "paymentMethodCreditCardDetails": null
    },
    "invoiceStatus": "PartialRefund",
    "subtotal": 10.99,
    "tax": 0.1,
    "total": 11.09,
    "billingDate": "29-Mar-26",
    "merchantLegalName": "John Doe",
    "merchantCustomerRefId": "c775514c-f194-4909-8c90-1381cc827d95",
    "customerFirstName": "John",
    "customerLastName": "Doe",
    "subscriptionId": null,
    "installmentId": null,
    "eligibilityFailReason": null,
    "merchantSubscriptionRefId": null,
    "networkTransactionId": null,
    "currency": null,
    "invoiceLineItems": null,
    "invoiceAttempts": null,
    "voidAttempts": null
  },
  "refunds": [
    {
      "invoiceAttemptId": 1,
      "amount": -3.99,
      "invoiceAttemptStatus": "Success",
      "invoiceAttemptDate": "2026-03-30T15:59:10.0447238Z",
      "paymentProcessor": "BridgePay",
      "processorTransactionId": null,
      "responseCode": null,
      "responseMessage": null,
      "processorRawResponse": null,
      "paymentMethod": {
        "paymentMethodId": 0,
        "billingAddressId": 0,
        "billingAddress": null,
        "billingFirstName": null,
        "billingLastName": null,
        "merchantPaymentMethodRefId": null,
        "paymentMethodAchDetails": null,
        "paymentMethodCreditCardDetails": null
      },
      "descriptor": {
        "subMerchantId": null,
        "subMerchantName": null,
        "subMerchantPhone": null,
        "countryCode": null,
        "city": null
      },
      "eligibilityCheckOrderCode": null,
      "processorMerchantId": null,
      "processingMethod": "None",
      "revolv3ResponseCode": null,
      "revolv3ResponseMessage": null,
      "authCode": null,
      "processorResponseDateTime": "2026-03-30T15:59:10.0447238Z"
    }
  ],
  "refundedSubtotal": 5.99,
  "refundedTax": 0.05,
  "refundedTotal": 6.04,
  "rawResponse": null,
  "message": null,
  "responseCode": null,
  "responseMessage": null,
  "revolv3ResponseCode": null,
  "revolv3ResponseMessage": null
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

invoiceId
integer<int64>
required

Body

amount
number<double> | null
includeRawProcessorResponse
boolean | null

Response

OK

invoice
object
refunds
object[] | null
refundedSubtotal
number<double>
refundedTax
number<double>
refundedTotal
number<double>
rawResponse
string | null
message
string | null
responseCode
string | null
responseMessage
string | null
revolv3ResponseCode
string | null
revolv3ResponseMessage
string | null