For the complete documentation index, see llms.txt. Any page on this site can be fetched as Markdown by appending .md to its URL.

Capture Payment InformationVoicecredit_cardPaymentscapturePaymentInformation· Version 1.0.0

Securely capture card details from the caller via DTMF and charge them.

Hands the call to the PCI-isolated payment handler, which prompts the caller to key in their card number, expiry, and (optionally) CVV and billing ZIP, then charges the configured amount through the selected payment integration (Authorize.net or Meridian Payments). Meridian Payments sells only (authCapture) and needs the customer account number, the convenience fee, Capture CVV, and Capture Billing ZIP; without them the node routes on fallback before the caller is asked for a card. Card data never enters the workflow. Only the result, the card brand and last four digits, the transaction details and reason from the gateway, and, for tokenize, the stored profile ids are returned. Routes on default when approved, declined when the gateway declines, invalidInput when the caller fails to enter valid details, and fallback on a gateway or system error. A fallback with <prefix>_outcomeUnknown set to true means the card may have been charged anyway: do not retry the charge. If the call is being recorded, the recording is paused before the first card prompt and resumed when the capture ends, so that card entry is left out of the audio; a recording that starts during the capture starts paused. When the pause cannot be confirmed, Tandem tries to stop and delete the recording of the call, and the capture goes ahead. If neither the pause nor the delete can be confirmed, the capture still goes ahead and card entry may be in the recording.

Fields

FieldTypeRequiredDescription
Payment Integration
integrationId
dynamicDropdownRequiredThe connected Authorize.net or Meridian Payments integration to charge through.
Transaction Type
transactionType
stringRequiredauthCapture charges immediately; authOnly authorizes for later capture; tokenize stores a reusable payment token.
Amount
amount
stringRequiredThe amount to charge, as a decimal string (e.g. "10.00"). Supports $(variable) substitution.
Invoice Reference
invoiceRef
stringOptionalOptional invoice/order reference passed to the gateway.
Description
description
stringOptionalOptional description passed to the gateway.
Customer Account Number
customerAccountNumber
stringOptionalThe member account number to apply the payment to. Required by Meridian Payments, along with Convenience Fee, Capture CVV, and Capture Billing ZIP. Ignored by Authorize.net. Supports $(variable) substitution.
Convenience Fee
convenienceFee
stringOptionalThe convenience fee the caller agreed to, as a decimal string (e.g. "2.50"). Required by Meridian Payments, along with Customer Account Number, Capture CVV, and Capture Billing ZIP. Ignored by Authorize.net. Supports $(variable) substitution.
Name on Card
nameOnCard
stringOptionalOptional cardholder name, up to 50 characters. Used by Meridian Payments; ignored by Authorize.net. Supports $(variable) substitution.
Capture CVV
captureCvv
booleanOptionalPrompt the caller for the card security code (CVV). Required by most gateways for card-not-present.
Capture Billing ZIP
captureZip
booleanOptionalPrompt the caller for the billing postal code (AVS).
Invalid Entry Retries
invalidEntryRetryCount
numberOptionalHow many times to re-prompt the caller when a field entry is invalid or incomplete.
Card Number Prompt
promptPan
dynamicDropdownRequiredPrompt asking the caller to key in the card number.
Expiry Prompt
promptExpiry
dynamicDropdownRequiredPrompt asking the caller to key in the expiration date (MMYY).
CVV Prompt
promptCvv
dynamicDropdownOptionalPrompt asking the caller to key in the security code.
Billing ZIP Prompt
promptZip
dynamicDropdownOptionalPrompt asking the caller to key in the billing postal code.
Result Variable Prefix
responseVariablePrefix
stringRequiredPrefix for the result variables written after the charge: <prefix>_result, <prefix>_last4, <prefix>_brand, <prefix>_transId, <prefix>_authCode, <prefix>_avsResult, <prefix>_message, <prefix>_outcomeUnknown, and, for tokenize, <prefix>_customerProfileId and <prefix>_paymentProfileId.

Exits

defaultdeclined

System exits (auto-injected, hidden when unwired): invalidInput, fallback.

On this page