Not every transaction starts with a tap or swipe. Manual entry gives your business the flexibility to accept payments even when cards can’t be read physically. With Finix, you can enable secure, network-compliant manual card entry right on the terminal—ideal for phone orders, card damage, or remote checkout scenarios.
In this guide, you can learn how to manually enter card details on the terminal.
All Standalone Terminals come with the capability to manually enter card details. Follow the steps below to process a manual entry transaction.
- Navigate to the Checkout Screen on your terminal.
- Enter the amount you wish to charge the customer.
- Click on Next.
- Select Manually enter a card.
- Enter the card details.
- Click Confirm and Pay.
The screenshots below show the manual entry flow on Standalone Terminals.
To enable manual entry for your POS integration, update your device's configuration via the Finix API, then create a sale as normal. Once enabled, the terminal prompts the cashier to enter card details manually before processing. For full reference, see the Update Device API.
Prerequisites:
- You have a POS Integration with Finix.
- You have a terminal associated with your POS Integration.
- You have a Finix Device ID for the terminal you want to update.
Enable Manual Entry Request
curl https://finix.sandbox-payments-api.com/devices/DVc9sV7fddxiJQqjqNEKrETg \
-H "Content-Type: application/json" \
-H 'Finix-Version: 2022-02-01' \
-u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \
-X PUT \
-d '{ "configuration": {
"prompt_manual_entry": true
}
}'Enable Manual Entry Response
{
"id": "DVc9sV7fddxiJQqjqNEKrETg",
"created_at": "2025-04-20T23:33:55.600925Z",
"updated_at": "2025-04-20T23:33:55.600925Z",
"configuration_details": {
"allow_debit": true,
"check_for_duplicate_transactions": true,
"prompt_amount_confirmation": true,
"prompt_manual_entry": true,
"signature_threshold_amount": 10000,
"bypass_device_on_capture": true,
"prompt_receipt_confirmation": true,
"display_tip_on_receipt": false,
"prompt_tip_on_screen": false,
"allow_standalone_authorizations": false,
"allow_standalone_sales": false,
"allow_standalone_refunds": false,
"tipping_details": {
"percent_tipping_threshold": 0,
"percent_options": [20, 30, 35],
"fixed_options": [100, 150, 200]
},
"idle_message": null,
"idle_image_file_id": null,
"automatic_receipt_delivery_methods": ["PRINT", "EMAIL", "SMS"],
"available_receipt_methods": ["PRINT", "EMAIL", "SMS"],
"prompt_for_signature": "NEVER",
"surcharge_basis_points": null
},
"description": "Cashier One",
"enabled": false,
"idle_message": null,
"merchant": "MU7noQ1wdgdAeAfymw2rfBMq",
"model": "PAX_A800",
"name": "My PAX_A800 Finix Device",
"serial_number": "19046260945",
"tags": {},
"_links": {
"self": {
"href": "https://finix.sandbox-payments-api.com/devices/DVc9sV7fddxiJQqjqNEKrETg"
},
"merchant": {
"href": "https://finix.sandbox-payments-api.com/merchants/MU7noQ1wdgdAeAfymw2rfBMq"
},
"transfers": {
"href": "https://finix.sandbox-payments-api.com/transfers"
},
"authorizations": {
"href": "https://finix.sandbox-payments-api.com/authorizations"
}
}
}Create Sale Request
curl -i -X POST \
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
https://finix.sandbox-payments-api.com/transfers \
-H 'Accept: application/hal+json' \
-H 'Content-Type: application/json' \
-H 'Finix-Version: 2022-02-01' \
-d '{
"amount": 150,
"currency": "USD",
"device": "DV7DvjGoZ2AEdhAKhtKXVv4b",
"operation_key": "CARD_PRESENT_SALE",
"tags": {
"order_number": "chris123transfer"
}
}'Create Sale Response
{
"id": "TRarp7Pz21Low4u2Urw5Ub4W",
"created_at": "2019-04-29T20:44:00.13Z",
"updated_at": "2022-10-10T05:59:17.59Z",
"3ds_redirect_url": null,
"additional_buyer_charges": null,
"additional_healthcare_data": null,
"address_verification": null,
"amount": 3138,
"amount_requested": 3138,
"application": "APeUbTUjvYb1CdPXvNcwW1wP",
"capture_amount": 150,
"card_present_details": {
"emv_data": {
"application_identifier": "A0000001523010",
"application_label": "DISCOVER",
"application_preferred_name": null,
"application_transaction_counter": "0005",
"cryptogram": "ARCQ F666F8891F870D33",
"issuer_code_table_index": null,
"pin_verified": false,
"tags": null
},
"masked_account_number": "************0059",
"name": "Test Card 05",
"brand": "DISCOVER",
"entry_mode": "CHIP_ENTRY",
"payment_type": "CREDIT",
"approval_code": "004839"
},
"currency": "USD",
"device": "DVfKLD9GZtsjcJxLtc2yCcfd",
"expires_at": "2019-05-06T20:44:00.13Z",
"failure_code": null,
"failure_message": null,
"idempotency_id": null,
"is_void": false,
"merchant": "MUeDVrf2ahuKc9Eg5TeZugvs",
"merchant_identity": "IDsbTBawhnLBAVeinRb84vFR",
"messages": [],
"raw": null,
"security_code_verification": null,
"source": "PImTHaz7XVPx4M7mhu9x8gkU",
"state": "SUCCEEDED",
"tags": {
"TicketNumber": "45878"
},
"trace_id": "FNX35FSuraeKKJr65wkGVFJni",
"void_state": "UNATTEMPTED",
"_links": {
"self": {
"href": "https://finix.sandbox-payments-api.com/authorizations/AUarp7Pz21Low4u2Urw5Ub4W"
},
"application": {
"href": "https://finix.sandbox-payments-api.com/applications/APeUbTUjvYb1CdPXvNcwW1wP"
},
"transfer": {
"href": "https://finix.sandbox-payments-api.com/transfers/TRqQCAX7nYHUnkE5YPFTknqd"
},
"device": {
"href": "https://finix.sandbox-payments-api.com/devices/DVfKLD9GZtsjcJxLtc2yCcfd"
},
"merchant_identity": {
"href": "https://finix.sandbox-payments-api.com/identities/IDsbTBawhnLBAVeinRb84vFR"
}
}
}The screenshots below show the manual entry flow on POS Terminals after a sale is initiated.