| Table of Contents |
|---|
Overview
...
| Field | Required | Description |
|---|---|---|
| client_id | Required | Generated Client ID |
| access_token | Required | User access token |
Merchant ID and PIN **DEPRECATED**
For more information on obtaining your PIN, see: Generating a Merchant Gateway Pin
Optional Fields
| Field | Required | Max Length | Description |
|---|---|---|---|
| x_relay_url | Optional | an. .. | Contains the URL to which the gateway will post the response. Include http:// or https://. When set the gateway response will automatically be sent via HTTP POST to this location. |
| x_relay_type | Optional | a. 7 | Indicates the type of action of the response. When ACTIVE is set the browser will automatically be sent to the location specified with x_relay_url. When PASSIVE is set the browser will not be redirected, but the response will be sent to the location specified with x_relay_url via HTTP POST. This is set to default to PASSIVE |
x_debug | Optional | n. 1 | When set to 1 (numerical one) transactions will be sent in test mode. A response will be given for the transaction, but no processing will occur. Default: 0 (zero). |
| x_version | Optional | ns 3 | DEFAULT: 1.1 (When this value is set to 1.2, the transaction Gateway Response will be returned in JSON format, rather than XML format) |
...
| Field | Required | Max Length | Description |
|---|---|---|---|
| x_cc_type | For cc transactions: Optional | a 2 | Card Types:
|
| x_cc_name | Optional | a 32 | Contains the name located on the credit card |
| x_cc_number | Conditional | n 22 | Contains the credit card number. Can send the x_payment_token_id to reference an existing Credit card on file. |
| x_cc_exp | Conditional | n 4 | Contains the expiration date for the credit card. Format: MMYY Can send the x_payment_token_id to reference an existing Credit card on file |
| x_cc_cvv | Optional | n 4 | Three or Four digit validation number for the credit card |
| x_ticket_id | Conditional | n 32 | Ticket ID of a transaction previously approved by the gateway. This is required for the following transaction types: DS (capture), CR (refund), VO (void) |
| x_authorization | Conditional | n 32 | Authorization code of a transaction previously authorized by the gateway. This is required for the following transaction types: OF (offline force) |
| x_trackdata | Optional | n 4 | Combined Track1 and Track2 data from credit card POS device. |
Example Requests
Credit Card AUTH-CAPTURE
Request
...
| x_token | Optional | ans .. | A valid 3DS (3D Secure) payment token, issued by a trusted provider offering payment tokenization, must be presented in this field. The x_token field value must be included along with the other conditionally required fields for Credit Card type transactions (x_cc_number, x_cc_exp and x_cc_cvv). |
Example Requests
Credit Card AUTH-CAPTURE
Request
POST https://secure.gotobilling.com/os/system/gateway/transact.php
Content-Type: application/x-www-form-urlencoded
merchant_id = "123456"
merchant_pin' = "gatewayPin"
x_transaction_type = "ES"
x_customer_id = "27500000001"
x_first_name = "Test"
x_last_name = "Account"
x_zip = "55555"
x_amount = "36.00"
x_cc_number = "4111111111111111"
x_cc_name = "Ester Tester"
x_cc_exp = "1215"
...
<ResponseData> <status>D</status> <order_number>122879-20081217198384</order_number> <term_code>0</term_code> <tran_amount>1.01</tran_amount> <tran_date>20081217</tran_date> <tran_time>131643</tran_time> <invoice_id>44444</invoice_id> <description>CHEXDIRECT|DECLINE CHECK|3 UNPAIDS (ALL)|UNPAID AMT= 35|PHN 800-238-5888|EXPRESS RECOVERY</description>
</ResponseData>
Level
...
1 Verification Information
Level 2 verification will return some 1 ACH verification compares the given account information against a neg file database. Results for accounts that do not contain any negative data will return an AUTH NUM indicating that no negative events have been recorded for the account. Additional info will be passed in the <description> field.
Additional Info
| value | description |
|---|---|
| History of Ineligible | Account does have a reported history and there is known transaction history on the account. |
| Routing Number is Invalid | Invalid bank routing number |
| History of Unauthorized | Account does not have a reported history or returns for Account Closed, Invalid Account, No account found, or Unable to locate, the routing number and account format are verified and there is no known transactional history on the account. |
Wrong Account Structure | The account identified as suspicious format |
| Not populated | Account does not have a reported history or returns for Account Closed, Invalid Account, No account found, or Unable to locate, the routing number and account format are verified, and there is known transactional history on the account. |
Format Accept
<auth_code>
AUTH NUM
</auth_code>
Example Accept
<auth_code> AUTH NUM 6847027C </auth_code>
Format Warning/Reject
<description>
ADDITIONAL INFO
</description>
Example Warning/Reject
<description>
HISTORY OF UNAUTHORIZED
</description>Debug and Test ACH Information
| decision | value | bank name | routing number | account number |
|---|---|---|---|---|
| ACCEPT | Valid (AUTH NUM) | Bank of America | 053200983 | 11101010 |
| WARNING | History of Ineligible | Bank of America | 226078036 | 13590100098321 |
| WARNING | Routing Number is Invalid | Bank of America | 053200983 | 11101012 |
| DECLINE | History of Unauthorized | Bank of America | 226078036 | 13590100098319 |
| WARNING | Wrong Account Structure | Bank of America | 053200983 | 11101015 |
Level 2 Verification Information
Level 2 verification will return some additional information with the verification AUTHNUMAUTH NUM. This additional info will be passed with the AUTHHUM AUTH NUM in the <description> field with a pip ("|") delimiter.
Additional Info
| value | description |
|---|---|
| Non-Participating: Negative Information | This customer's bank does not participate in the Bank ACH Verification system. However, the normal negative database has negative information (returned checks) that are in the system. |
| ACH Unavailable | This merchant's bank account is not able to be debited via the ACH system. |
| Non-Participating: No Info | This customer's bank does not participate in the Bank ACH Verification system and the customer's bank account has not been seen in the negative database system. |
| Account Closed or Neg Status | The customer's bank participates in the Bank ACH Verification system and is reporting this account as Closed or in a state that will result in the ACH transaction being returned. |
| Account Good | The customer's bank participates in the Bank ACH verification system and is reporting this account as open and in good standing. |
Format
<description> AUTH AUTHNUMNUM|ADDTIONALINFOADDITIONAL INFO </description>
Example
<description> AUTH NUM 53793041|Non-Participating: No Info </description>
...