Difference between revisions of "Gateway Biller Details Query Letter"
Line 198: | Line 198: | ||
=== Transaction Notifications Using Postbacks === | === Transaction Notifications Using Postbacks === | ||
If you elect to send NATS information about transactions using a | If you elect to send NATS information about transactions using a | ||
− | postback, please | + | postback, please fill in the following table with the fields sent: |
+ | {| border="1" | ||
+ | |Field | ||
+ | |Description | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | | | ||
+ | | | ||
+ | |} | ||
− | + | Fields required by NATS: | |
− | + | * Transaction Type | |
− | + | * Indication whether transaction was approved | |
− | * | + | * Passthrough variable (if posting initials) |
− | + | * Transactionid | |
− | + | * Subscriptionid | |
− | * | + | * Reference Transactionid (required for credits, chargebacks, and reversals) |
− | + | * Amount | |
− | + | * Currency (required for multi-currency support) | |
− | |||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | * | ||
− | |||
− | |||
− | * | ||
− | |||
== IP Addresses (for postbacks only) == | == IP Addresses (for postbacks only) == |
Revision as of 11:44, 30 April 2010
Please email your your answers to this questionnaire, your full integration document, your testing account information, and your test purchase information to boris@toomuchmedia.com.
Basic Information
- Company Name:
- Your name:
- Your email:
- Your phone number:
- Your TMMID (you must register for a TMMID at tmmid.com)
- Name of Developer:
- Developer's phone number:
- Developer's AIM/ICQ:
- Name of Project Manager:
- Project Manager's phone number:
- Project Manager's AIM/ICQ:
- What processing types do you support (for example: CC, Check, Dialer):
- What transaction types do you support (for example: initial, credit, void)?:
Required Fields and Definitions
- transactionid -- a unique identifier for each transaction
- subscriptionid -- a unique identifier for each subscription
- transaction reference id -- for credits, chargebacks, and reversals. The identifier for the original transaction being credited/etc.
- passthrough variable -- a variable we can use to pass custom information, which will be included with initial transactions.
Gateway Communication
What method does NATS use to communicate with your system (ex: https post, xml, SOAP)
Please list what fields we can send to your system for initial transactions, and whether they are required by your system
Field | Required | Type | Max Length | Description |
Required fields for the post sent:
- passthrough variable.
Please list what fields are returned in your response
Field | Description |
Required fields for the response:
- transactionid
- subscriptionid (for recurring subscriptions)
- amount
- currency (required for multi-currency support)
Notification of Initial, Rebill, Credit, and Chargeback Transactions
You need to send information about rebill, credit, and chargeback transactions. NATS can get that information in two formats:
- Your system sends NATS a postback.
- NATS polls your reporting script on a regular basis. (Preferred)
- Do you have a postback system?:
- Do you have a reporting script?:
- Are initials reported in either (optional. To process initials, we need our passthrough variable)?:
Transaction Notifications Using Postbacks
If you elect to send NATS information about transactions using a postback, please fill in the following table with the fields sent:
Field | Description |
Fields required by NATS:
- Transaction Type
- Indication whether transaction was approved
- Passthrough variable (if posting initials)
- Transactionid
- Subscriptionid
- Reference Transactionid (required for credits, chargebacks, and reversals)
- Amount
- Currency (required for multi-currency support)
IP Addresses (for postbacks only)
Please list every IP address that will send information to NATS:
Optionally, please give us a URL where we can download an updated list in a computer readable format of IP addresses that will send information to NATS. To make upgrades to your service easy, we highly recommend you provide this URL.
URL:
If you are not able to provide us with an updated list of IP addresses, how can nats verify that a post is from your system?
Transaction Notification Using a Poll to a Reporting Script
If you elect to let NATS get information about transactions by accessing a reporting script, please answer the following questions:
- What fields are contained in the response?:
- What types of transactions will be reported (example: rebill, return/credit, cancel, expire)?:
- How should NATS identify the transaction type?:
- How can NATS identify approved transactions?:
- Which field contains our passthrough variable (if reporting initials)?:
- Which field contains the transactionid?:
- Which field contains the subscriptionid?:
- Which field contains the amount?:
- Which field contains the currency (required for multi-currency support)?:
- Are they any restrictions on the reporting (ie: date range or frequency)?:
Instant Upgrades (Optional)
Does your system support instant upgrades?:
If your system does support instant upgrades, it must send a postback to
NATS. Please answer the following questions about the instant
upgrade postback:
- What fields are contained in the postback?:
- How can NATS identify approved transactions?:
Cross Sells and Upsells (Optional)
Does your system support cross sells?:
Does your system support upsells?:
If you system supports cross sells, upsells, or both, please answer the
following questions:
- What fields should NATS send to you?:
- What field should NATS use to send the passthrough variable?:
Your system must return the cross sell status to the NATS process
script.
- What fields will you send to the process script?:
- Which field contains the NATS passthrough variable?:
Gateway Communication
- What fields must NATS send to your transaction form?:
- Which field should NATS use to send the price?:
- In your response, how do we identify approved transactions?:
- In your response, which field contains the transaction identifier?:
- In your response, which field contains the subscription identifier?:
Other Special Features
Do you have any special features not addressed by this document?:
If you answered yes, please describe the special features below.