Card Present Sale with Manual Entry
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": "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) |
{
"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"
}
}
}