--- title: "Send card transaction to be processed." method: POST path: "/transactions/process/card" tags: ["Transactions"] --- # Send card transaction to be processed. `POST /transactions/process/card` ## Request - Base URL: `https://tb.paymentfusion.com` - URL: `https://tb.paymentfusion.com/transactions/process/card` - Auth: none declared. Required headers: `Authorization`, `Accept`, `Content-Type` Called by the Independent Software Vendor. Sends a card transaction directly to the gateway for processing. This is only used with saved credit card tokens, not actual credit card numbers. ## Headers - `Authorization` string, api_id:api_token, required - `Accept` string, required - `Content-Type` string, required ## Request body `application/x-www-form-urlencoded` - object - `merchant_id` string, required: The merchant identifier that will be used to connect to the gateway. Size range - `1..16` - `amount` string, required: The amount in USD up to 6 decimals that will be charged, must be a number greater than 0 and its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `card` string, required: The credit card token. - `invoice` string: Number of the invoice. - `software` string: ISV software identifier. - `ip_address` string: IP address of the client requesting the transaction. - `clerk` string: Sales Clerk. Optional value indicating the clerk/person processing transaction, for reporting purposes. - `billing_street` string: Billing street address for credit cards. - `billing_city` string: Billing city for credit cards. - `billing_state` string: Billing state for credit cards. - `billing_zip` string: Billing zip code for credit cards. - `comments` string: Transaction comments. - `description` string: Transaction description. - `command` string: The operation that will be performed. "sale" makes the transaction right away while "authorize" simply authorizes the maximum amount that can be later captured and "independent_return" makes a refund of the transaction. Allowed values - `"sale"`,`"authorize"`,`"independent_return"`. - `tip_amount` string: The tip amount that was added to this transaction, in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). Default value - `0` - `force_duplicate` boolean: Specifies if this transaction can bypass duplicate error. Applies to payment_fusion gateway only. Allowed values - `true`,`false` - `allow_partial_auth` boolean: Sets the flag for allowing partial payment - `zip_code` string: 5 digit ZIP code. Optional value indicating the cardholder's zip code. - `street_address` string: Optional value indicating the cardholder's street address. - `tax_amount` string: Optional value indicating the tax amount that will be charged, in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `remote_id` string: Used for keeping track of a 3rd party identifier alongside the transaction object. This is typically used by the ISV to assign its own identifier to the transaction for easy matching in case any network issues appear. This is not validated for uniqueness. Size range - `0..256`. - `client_id` string: Used to track the workstation associated with the transaction. - `healthcare` HealthcareRequestFields: Optional parameters passed to the gateway. - `iias_verified` 'true' | 'false' | 'exempt': Merchant verified/did not verify the purchased items against an IIAS or Merchant claims exemption from IIAS based on the 90 percent rule. - `healthcare_amount` string: Amount health-care. Field includes the amounts in prescription_amount, vision_amount, clinic_other_amount, dental_amount and should always be equal or greater to their sum. Available for Visa and Mastercard only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `prescription_amount` string: Total amount of prescriptions used to gain access to "Rx Only" purses. This amount is included in the health-care_amount. Available for Visa and Mastercard only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `copay_amount` string: Total amount for co-payments. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `vision_amount` string: Total amount of vision care purchases. This amount is included in healthcare_amount. Available for Visa only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `clinic_other_amount` string: Total amount of clinic or other medical services. This amount is included in healthcare_amount. Available for Visa only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `dental_amount` string: Total amount of dental services. This amount is included in healthcare_amount. Available for Visa only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `transit_amount` string: Total amount charged to an FSA card for transportation to/from a healthcare provider. Available for Visa only. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). - `cumulative_amount` string: Total cumulative authorized amount for a series of incremental authorization transactions. Described in USD up to 6 decimals, its last 4 digits must be 0. (e.g. "1", "1.00", "1.01", "1.2", "1.230000"). ## Response `200` Success - object - `amount` string: Passthrough of original transaction request amount - `auth_amount` string: The authorized amount in case of a partial authorized transaction - `gateway_auth_code` string: The authorization code received from the gateway - `card_type` string: The type of the card that was submitted. Allowed values - `"Discover"`, `"DISCOVER"`, `"UnionPay"`, `"AmEx"`, `"AMERICAN EXPRESS"`, `"AMEX"`, `"American express"`, `"Master"`, `"MASTERCARD"`, `"Mastercard"`, `"MASTERCARD/Mastercard"`, `"JCB"`, `"Jcb"`, `"Visa"`, `"VISA"`,`"Visa Traditional"`, `"Visa Classic"`, `"Visa Health"`, `"Visa Prefered"`, `"Mastercard/Eurocard"`, `"DINERS"`, `"CareCredit"`, `"Unknown Code"`, `"OTHER"`, `"null"`, `"N/A"` The values are subject to change. - `created_at` string: The time the transaction was created. - `gateway_identifier` 'usaepay' | 'payment_fusion': Identifier of the gateway. - `gateway_reference_number` string: Transaction reference number from gateway. - `gateway_response_message` string: The message returned from the gateway - `gateway_result_code` string: Result code (or error code) as returned by the gateway - `gateway_result_text` string: The result text as returned by the gateway. - `merchant_id` string: The merchant identifier that will be used to connect to the gateway. Size range - `1..16` - `mid` string: The merchant ID - `remote_id` string: Used for keeping track of a 3rd party identifier alongside the transaction object. This is typically used by the ISV to assign its own identifier to the transaction for easy matching in case any network issues appear. This is not validated for uniqueness. Size range - `0..256`. - `tid` string: The terminal ID - `tip_amount` string: The tip amount in USD that was added to this transaction. Default value - `0` - `transaction_status` string: Confirmation from the payment gateway regarding the CC credentials and payment finalization. Allowed values - `"approved"`, `"awaiting_amount"`, `"awaiting_confirmation"`, `"canceled"`, `"declined"`, `"emv_needing_reversal"`, `"error"`, `"in progress"`, `"internal error"`, `"timeout"`, `"verification"`, `"Success"`, `"Failure"` - `allow_partial_auth` boolean: Partial authorization indicator that reflects whether the processor provided a partial authorization. - `is_partial_auth` boolean: Partial authorization indicator that reflects whether the processor provided a partial authorization. - `v` string: The API version that was used to handle the request. ## Other responses - `4XX`: Possible errors - 1, 5, 6, 11, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 59, 63, 67, 70, 72, 73, 74, 75, 76, 77, 78, 79, 80, 82, 84, 85, 103, 105, 106, 107, 108, 112, 118, 147, 163, 189, 205, 219, 227, 228, 229, 231, 232, 240, 257, 259, 270, 271, 272, 291 - `5XX`: Possible errors - 8, 261 --- [API](https://skmtc.dev/bankofamerica/apis/transaction-broker-api.md) - [All operations](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bankofamerica/apis/transaction-broker-api/revisions/6097bc689e41?raw)