Refund an invoice

Performs a full refund of an invoice. The refunded amount is deducted from your integrator account and refunded to the payment method(s) originally charged.

NOTE: For invoices that contain user_to_user line items, funds are deducted from your integrator account, NOT the recipient user's wallet.

Successful completion triggers these notifications
Invoice complete
Refund completed

For more information about event notifications, visit Webhooks.

Securitytilia_auth
Request
Request Body schema: application/json
required

Refund resource

invoice_id
required
string <= 36 characters

The id for the invoice to fully refund. In the case of an escrow transaction, this would be the escrow_invoice_id.

reason
string

Main reason for performing the refund. Must be one of billing, fraud, product_related, other.

sub_reason
string

Secondary reason for performing the refund.

note
string

Any additional notes about the refund.

Responses
200

Successfully created full refund request

400

Invalid input

401

Unauthorized access.

403

The transaction was rejected

404

Invoice not found.

500

Service unavailable or server error.

post/v2/refund
Request samples
application/json
{
  • "invoice_id": "inv_2V2XDLW6zogChdShdFh8WKOhHii",
  • "reason": "billing",
  • "sub_reason": "Charged twice",
  • "note": "string"
}
Response samples
application/json
{
  • "status": "Success",
  • "message": null,
  • "codes": null
}