Refunds

This feature is used to issue refunds to the customer. Refunds are split in two:

  • Full Refunds
  • Partial Refunds
POST https://api.quaife.net/v1/transactions/{id}/refunds

Path parameters

Parameter

id

Type

string

Description

The transaction identifier

Request body parameters

Parameter

amount

Type

number

Description

Refund Amount
currency
string
ISO 3 Currency Code

Full Refund

For a full refund, the ‘amount’ in the Request Body should be IDENTICAL to that of the transaction being refunded.

JSON Request object

{
“amount”:10.26, “currency”: “EUR”, “reference”: “REF-234234”, “reason”: “Fraudulent”
}

JSON Response object

{
    "id": "ref_eaj71fe0b1",
    "status": "Captured",
    "created": "2021-01-06T15:54:45.771475Z"
}

Status of the original Transaction will be updated to Refunded.

Partial Refund

For a partial refund, the ‘amount’ in the Request Body should be LESS than that of the transaction being refunded.

JSON Request object

{
    "amount":5.53,
    "currency": "EUR",
    "reference": "REF-234231",
    "reason": "Fraudulent"
}

JSON Response object

{
    "id": "ref_hw8cobf23u",
    "status": "Captured",
    "created": "2021-01-06T15:54:45.771475Z"
}

Status of the original Transaction will be updated to PartiallyRefunded.

Reversals

POST https://api.quaife.net/v1/transactions/{{Id}}/reversals

Path parameters

Parameter

Type

Description

id
string

The transaction identifier

Request body parameters

Parameter

Type

Description

reference <= 50

string

A reference you can later use to identify this capture request

reason <= 100

string

Reversal reason

JSON Request object

{
"reason": "because of...",
"reference": "insert reference here"
}

JSON Response object

{
“id”: “rev_8vmsa3llw6”,
“status”: “Captured”,
“created”: “2021-01-06T15:53:44.2790708Z”
}

MERCHANT

Should you be interested in becoming a merchant, then please fill out the short form below and one of our specialists will be in touch shortly.

SIGN UP

We are delighted that you are considering using Quaife as your payment partner. Fill in the form below & let’s get started.