Deprecated API Reference

This API Reference is being deprecated. Please use the New API Reference.

Card Present Sale with Manual Entry

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 \
 -H "Content-Type: application/vnd.json+api" \
 -H 'Finix-Version:2022-02-01' \
 -u  USjHFGYvecE4LBitYG8KDE2g:b698f403-d9b7-4157-82d8-162cea8c8cc3 \
 -d '
 {
   "device": "DVf2H8sh4LZZC52GTUrwCPPf",
   "tags": {
     "order_number": "chris123transfer"
   },
   "device_configuration": {
     "prompt_manual_entry": true
   },
   "currency": "USD",
   "amount": 150,
   "operation_key": "CARD_PRESENT_DEBIT"
 }'

HTTP Request

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

Request Arguments

Field Type Description
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:allow\_debit boolean, optional Sets whether device will allow debit by default or not (defaults to true)
device\_configuration: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 device_configuration#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
device\_configuration:check\_for\_duplicate\_transactions boolean, optional Sets whether the device will check for duplicate transactions
device\_configuration:signature\_threshold\_amount integer, optional Threshold set for when to prompt a signature if device\_configuration:prompt\_signature is set to AMOUNT (defaults to 0)
device\_configuration: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)
Copy
Copied
{
  "id" : "TR5YqMmCAZjYhJv1gpVURKVu",
  "amount" : 150,
  "tags" : {
    "order_number" : "chris123transfer"
  },
  "state" : "SUCCEEDED",
  "trace_id" : "FNXadxVLNR3hRaR47zYpNgRNA",
  "currency" : "USD",
  "application" : "APeUbTUjvYb1CdPXvNcwW1wP",
  "source" : "PI4cDtcVhvG8WwnQiC9RfEYQ",
  "destination" : null,
  "ready_to_settle_at" : null,
  "fee" : 0,
  "statement_descriptor" : "FIN*GOLDS GYM",
  "type" : "DEBIT",
  "messages" : [ ],
  "raw" : null,
  "card_present_details" : {
    "emv_data" : null,
    "masked_account_number" : "************0006",
    "name" : "",
    "brand" : "VISA",
    "entry_mode" : "MANUAL_KEY_ENTRY",
    "payment_type" : "CREDIT",
    "approval_code" : "000059"
  },
  "created_at" : "2019-03-11T23:58:45.25Z",
  "updated_at" : "2019-03-11T23:59:15.65Z",
  "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/TR5YqMmCAZjYhJv1gpVURKVu"
    },
    "payment_instruments" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TR5YqMmCAZjYhJv1gpVURKVu/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/TR5YqMmCAZjYhJv1gpVURKVu/reversals"
    },
    "fees" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TR5YqMmCAZjYhJv1gpVURKVu/fees"
    },
    "disputes" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TR5YqMmCAZjYhJv1gpVURKVu/disputes"
    },
    "source" : {
      "href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI4cDtcVhvG8WwnQiC9RfEYQ"
    }
  }
}