Straight Send

Straight Send is an innovative payment system for fast and convenient fund transfers to eligible debit cards. This Straight Send payment method credits funds to a recipient’s Debit Card account. Straight Send payment method tends to be cheaper, faster, more convenient and more traceable than traditional payment methods.

In this section:

For the entire list of API endpoints, refer to API Endpoints.

Request

Field nameDescriptionRequiredLengthData type
ssl_merchant_idMerchant ID
Elavon-assigned Converge Account ID (AID).
Required6 or 7numeric
ssl_user_idConverge User ID
The user ID with Hosted Payment API User status that can send transaction requests through the terminal.
Required15alphanumeric
ssl_pinTerminal ID
Unique identifier of the terminal that will process the transaction request and submit to the Converge gateway.

important

The ssl_user_id sending the transaction request must be associated with the terminal that will process the request.

Required64alphanumeric
ssl_amountTransaction Amount
The Sale amount that includes the Net and Sales Tax amount
Format: Number with 2 decimal places
Required11Numeric
ssl_transaction_typeTransaction Type
Valid value:   dboctdisbursement
Required20alphanumeric
ssl_card_numberCard Number
Unique card identification number.
Card length:
18 - Debit Card
Required18 or 19numeric
ssl_exp_dateCard’s Expiry Date
Date when the card becomes invalid.
Format: MMYY
Required4numeric
ssl_oct_ref_numberOCT Reference Number
This field is used to identify the sender reference number submitted with the Original Credit Transaction (OCT)
Required16numeric

Response

Field nameDescription
ssl_amountTotal Authorized/Approved Transaction Amount
Return based on merchant setup
ssl_approval_codeTransaction Approval Code
Unique code returned by the credit card processor that indicates the approval status of the transaction.
ssl_card_numberMasked Card Number
Converge only returns the first 2 or last 4 digits of the regular PAN
ssl_card_typePayment Type
Valid value:  DEBITCARD
ssl_card_short_descriptionShort Card Brand Name
Valid values are: MC and VISA.
ssl_exp_dateCard’s Expiry Date
Returned based on merchant setup
Format:  MMYY
ssl_transaction_currencyTransaction Currency
ssl_txn_idTransaction ID
Unique identifier of the transaction.
ssl_txn_timeProcessing Date and Time
Indicates when Converge processed the transaction.
Format: MM/DD/YYYY hh:mm:ss AM/PM
Example:   03/18/2010 10:34:10 AM
ssl_transaction_typeTransaction Type
ssl_issuer_responseOriginal Issuer Response
The issuer response returned during the authorization attempt.
An ssl_issuer_response = 00 indicates success.
An ssl_issuer_response not equal to 00 indicates a decline or failure.
ssl_resultTransaction Outcome
An ssl_result = 0 indicates an approved transaction.
An ssl_result not equal to 0 indicates a declined and unauthorized transaction.
ssl_result_messageTransaction Result Message
Refer to the Debit Card Response Codes section for an extensive list of possible returned messages.
[Card On File]
ssl_oar_dataOriginal Authorization Response Data
This data will be as received during the original authorization processing.
This is a retain and return value for terminal-based settlement messages.
You may store this field with the payment details from the transaction to make future Card On File transactions.
ssl_ps2000_dataPS2000
This data will be as received during the original authorization processing.
This is a retain and return value for terminal-based settlement messages.
You must store this field with the payment details from the transaction to make future Card On File transactions.

Examples

Request

xmldata=
<txn>
    <ssl_merchant_id>Merchant Account ID</ssl_merchant_id>
    <ssl_user_id>API User ID</ssl_user_id>
    <ssl_pin>Unique Terminal Identifier</ssl_pin>
    <ssl_amount>1.00</ssl_amount>
    <ssl_transaction_type>dboctdisbursement</ssl_transaction_type>
    <ssl_card_number>4000XXXXXXXX0001</ssl_card_number>
    <ssl_exp_date>MMYY</ssl_exp_date>
    <ssl_oct_ref_number>1234567890123456</ssl_oct_ref_number>
</txn>

Response

<txn>
    <ssl_result>0</ssl_result>
    <ssl_issuer_response>00</ssl_issuer_response>
    <ssl_result_message>APPROVAL</ssl_result_message>
    <ssl_card_number>50**********3003</ssl_card_number>
    <ssl_oar_data>9898 9889999999 9</ssl_oar_data>
    <ssl_txn_id>110620AD2-880072A9-628C-4556-9EAF-B2C54C0F1BBB</ssl_txn_id>
    <ssl_approval_code>N01032</ssl_approval_code>
    <ssl_amount>1.00</ssl_amount>
    <ssl_transaction_currency>USD</ssl_transaction_currency>
    <ssl_txn_time>06/11/2020 12:01:35 PM</ssl_txn_time>
    <ssl_exp_date>1220</ssl_exp_date>
    <ssl_card_short_description>VI</ssl_card_short_description>
    <ssl_card_type>DEBITCARD</ssl_card_type>
    <ssl_transaction_type>OCTDISBURSEMENT</ssl_transaction_type>
    <ssl_ps2000_data>X878787</ssl_ps2000_data>  
</txn>