Card Present Referenced Refund

Below are the different scenarios that outline whether a user needs to swipe their card for a refund.

No swipe needed: Included in the open batch or not, the payment type was credit, and the transaction is within 45 days.

No swipe needed: If the payment type was debit and the transaction is in the current open batch.

Swipe needed: If the payment type is debit and the transaction is no longer in the batch.

Swipe needed: If the payment type is credit and the transaction is no longer in the batch and older than 45 days.

attention

This API is available for Finix Core customers only. If you have additional questions, contact Support.

Copy
Copied
curl https://finix.sandbox-payments-api.com/transfers/TRkWoMAdBwfVgYQpL8csYbtH/reversals \
    -H "Content-Type: application/vnd.json+api" \
    -u  USjHFGYvecE4LBitYG8KDE2g:b698f403-d9b7-4157-82d8-162cea8c8cc3 \
    -d  '
        {
          "refund_amount" : 150,
          "device": "DVkBqa68V1ZQusodU8o6mB62"
        }'

HTTP Request

POST https://finix.sandbox-payments-api.com/transfers/:TRANSFER_ID/reversals

URL Parameters

Field Type Description
:TRANSFER_ID string, required ID of the original Transfer

Request Arguments

Field Type Description
device string, required The ID of the activated device
refund_amount integer, required The amount of the refund in cents (Must be equal to or less than the amount of the original Transfer)
{
    "id": "TRkWoMAdBwfVgYQpL8csYbtH",
    "amount": 150,
    "tags": {},
    "state": "SUCCEEDED",
    "trace_id": "FNXhYDzG8GLyL2gmE77Ygnjai",
    "currency": "USD",
    "application": "APuZMfMerci2JuLUs7xWpf5G",
    "source": null,
    "destination": "PIp89SyE68fV5rxRCZUJz39c",
    "ready_to_settle_at": null,
    "fee": 0,
    "statement_descriptor": "FNXQA*POLLOS HERMANOS",
    "type": "REVERSAL",
    "messages": [],
    "raw": null,
    "created_at": "2019-04-02T11:11:03.42Z",
    "updated_at": "2019-04-02T11:11:17.34Z",
    "idempotency_id": null,
    "merchant_identity": "ID8W4rxaFN8HsxqugmesLMVo",
    "device": "DVkBqa68V1ZQusodU8o6mB62",
    "subtype": "API",
    "_links": {
        "application": {
            "href": "https://finix.sandbox-payments-api.com/applications/APuZMfMerci2JuLUs7xWpf5G"
        },
        "self": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRkWoMAdBwfVgYQpL8csYbtH"
        },
        "parent": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRu7UQdLY3GG2EnPbKNazQYv"
        },
        "destination": {
            "href": "https://finix.sandbox-payments-api.com/payment_instruments/PIp89SyE68fV5rxRCZUJz39c"
        },
        "merchant_identity": {
            "href": "https://finix.sandbox-payments-api.com/identities/ID8W4rxaFN8HsxqugmesLMVo"
        },
        "payment_instruments": {
            "href": "https://finix.sandbox-payments-api.com/transfers/TRkWoMAdBwfVgYQpL8csYbtH/payment_instruments"
        }
    }
}