Card Present Unreferenced Refund with Swipe Card
attention
This API is available for Finix Core customers only. If you have additional questions, contact Support.
curl https://finix.sandbox-payments-api.com/transfers \
-H "Content-Type: application/vnd.json+api" \
-u USjHFGYvecE4LBitYG8KDE2g:b698f403-d9b7-4157-82d8-162cea8c8cc3 \
-d '
{
"device": "DVf2H8sh4LZZC52GTUrwCPPf",
"tags": {
"order_number": "testing123"
},
"currency": "USD",
"amount": 150,
"operation_key": "CARD_PRESENT_UNREFERENCED_REFUND"
}'
HTTP Request
POST https://finix.sandbox-payments-api.com/transfers
Request Arguments
Field | Type | Description |
---|---|---|
merchant_identity |
string, required | ID of Merchant |
tags |
object, optional | Key value pair for annotating custom metadata (e.g. order numbers) |
device |
string, required | The ID of the activated device |
amount |
integer, required | Amount of sale |
currency |
string, required | Currency of sale |
operation_key |
string, required | Describes the operation to be performed in the transaction |
device_configuration Arguments
Field | Type | Description |
---|---|---|
allow_debit |
boolean, optional | Sets whether device will allow debit by default or not (defaults to true). |
prompt_signature |
string, optional | Sets whether device will prompt the card holder for a signature by default or not, AMOUNT is used in conjuction with signature_threshold_amount so that when the threshold is reached the signature form appears on device screen (defaults to always). Options are: ALWAYS, NEVER, AMOUNT |
check_for_duplicate_transactions |
boolean, optional | Sets whether the device will check for duplicate transactions |
signature_threshold_amount |
integer, optional | Threshold set for when to prompt a signature if prompt_signature is set to AMOUNT (defaults to 0) |
prompt_manual_entry |
boolean, optional | Sets whether or not the default card input method will be keyed in manual entry or not (defaults to false) |
{
"id": "TR3vLiG6wecEwY3TC3oQiudG",
"amount": 100,
"tags": {
"order_number": "testing123"
},
"state": "SUCCEEDED",
"trace_id": "FNXgm7zyjYEmYwUQ3fktSTkaZ",
"currency": "USD",
"application": "APuZMfMerci2JuLUs7xWpf5G",
"source": null,
"destination": "PIiPybsvUSM4fN8sYaMS3qXg",
"ready_to_settle_at": null,
"fee": 0,
"statement_descriptor": "FNXQA*POLLOS HERMANOS",
"type": "CREDIT",
"messages": [],
"raw": null,
"card_present_details": {
"emv_data": null,
"masked_account_number": "************0006",
"name": "TEST/WORLDPAY",
"brand": "VISA",
"entry_mode": "SWIPED",
"payment_type": "CREDIT",
"approval_code": "000019"
},
"created_at": "2019-04-24T19:19:34.11Z",
"updated_at": "2019-04-24T19:19:48.09Z",
"idempotency_id": null,
"merchant_identity": "IDsbTBawhnLBAVeinRb84vFR",
"device": "DVf2H8sh4LZZC52GTUrwCPPf",
"subtype": "API",
"_links": {
"application": {
"href": "https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP"
},
"self": {
"href": "https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG"
},
"payment_instruments": {
"href": "https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/payment_instruments"
},
"merchant_identity": {
"href": "https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR"
},
"device": {
"href": "https://finix.sandbox-payments-api.com/devices/DVf2H8sh4LZZC52GTUrwCPPf"
},
"reversals": {
"href": "https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/reversals"
},
"fees": {
"href": "https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/fees"
},
"disputes": {
"href": "https://finix.sandbox-payments-api.com/transfers/TR3vLiG6wecEwY3TC3oQiudG/disputes"
},
"destination": {
"href": "https://finix.sandbox-payments-api.com/payment_instruments/PIiPybsvUSM4fN8sYaMS3qXg"
}
}
}