BAbankofamerica
Transactions

Send card transaction to be processed.

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.

post/transactions/process/card

Request

Headers

Authorizationstring api_id:api_token required

Needs to include Basic word before Base64 encoded api_id:api_token. The api_id is the identifier of the organization created on TAP; size range - up to 36 characters. The api_token is the unique token previously generated by TAP and provided securely to the organization; size range - 32. Example: Basic ODA5BVgrNdZkZmbiFlJlTThkYTA2eG00MzA5dHh1bWZnZgfdZDE=

Acceptstring required
Example:application/vnd.paymentfusion.v3.0.0+json

Specifies the requested API version. If this field is not specified or has an invalid format, the API will return an error. If the specified version does not exist, a 404 page will be displayed. Accepted values - application/vnd.paymentfusion.v3.0.0+json

Content-Typestring required
Example:application/x-www-form-urlencoded

The Content-Type entity header is used to indicate the media type of the resource.

Request body application/x-www-form-urlencoded

merchant_idstring required

The merchant identifier that will be used to connect to the gateway. Size range - 1..16

amountstring 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").

cardstring required

The credit card token.

invoicestring

Number of the invoice.

softwarestring

ISV software identifier.

ip_addressstring

IP address of the client requesting the transaction.

clerkstring

Sales Clerk. Optional value indicating the clerk/person processing transaction, for reporting purposes.

billing_streetstring

Billing street address for credit cards.

billing_citystring

Billing city for credit cards.

billing_statestring

Billing state for credit cards.

billing_zipstring

Billing zip code for credit cards.

commentsstring

Transaction comments.

descriptionstring

Transaction description.

commandstring

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_amountstring

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_duplicateboolean

Specifies if this transaction can bypass duplicate error. Applies to payment_fusion gateway only. Allowed values - true,false

allow_partial_authboolean

Sets the flag for allowing partial payment

zip_codestring

5 digit ZIP code. Optional value indicating the cardholder's zip code.

street_addressstring

Optional value indicating the cardholder's street address.

tax_amountstring

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_idstring

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_idstring

Used to track the workstation associated with the transaction.

Example request

{
  "healthcare": {
    "iias_verified": "string",
    "healthcare_amount": "string",
    "prescription_amount": "string",
    "copay_amount": "string",
    "vision_amount": "string",
    "clinic_other_amount": "string",
    "dental_amount": "string",
    "transit_amount": "string",
    "cumulative_amount": "string"
  }
}

Response

Success

amountstring

Passthrough of original transaction request amount

auth_amountstring

The authorized amount in case of a partial authorized transaction

gateway_auth_codestring

The authorization code received from the gateway

card_typestring

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_atstring

The time the transaction was created.

gateway_identifier'usaepay' | 'payment_fusion'

Identifier of the gateway.

gateway_reference_numberstring

Transaction reference number from gateway.

gateway_response_messagestring

The message returned from the gateway

gateway_result_codestring

Result code (or error code) as returned by the gateway

gateway_result_textstring

The result text as returned by the gateway.

merchant_idstring

The merchant identifier that will be used to connect to the gateway. Size range - 1..16

midstring

The merchant ID

remote_idstring

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.

tidstring

The terminal ID

tip_amountstring

The tip amount in USD that was added to this transaction. Default value - 0

transaction_statusstring

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_authboolean

Partial authorization indicator that reflects whether the processor provided a partial authorization.

is_partial_authboolean

Partial authorization indicator that reflects whether the processor provided a partial authorization.

vstring

The API version that was used to handle the request.

Example response

{
  "amount": "string",
  "auth_amount": "string",
  "gateway_auth_code": "string",
  "card_type": "string",
  "created_at": "string",
  "gateway_identifier": "string",
  "gateway_reference_number": "string",
  "gateway_response_message": "string",
  "gateway_result_code": "string",
  "gateway_result_text": "string",
  "merchant_id": "string",
  "mid": "string",
  "remote_id": "string",
  "tid": "string",
  "tip_amount": "string",
  "transaction_status": "string",
  "v": "string"
}

Changes

No recorded changes to this operation across all 1 revision of this API.