Difference between revisions of "Gateway Biller Details Query Letter"

From TMM Wiki
Jump to navigationJump to search
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
Please email your your answers to this questionnaire, your full integration document, your testing account
 
Please email your your answers to this questionnaire, your full integration document, your testing account
 
information, and your test purchase information to
 
information, and your test purchase information to
−
[mailto:boris@toomuchmedia.com boris@toomuchmedia.com].
+
[mailto:cho@toomuchmedia.com cho@toomuchmedia.com].
  
 +
'''Find a PDF copy of this file here: [https://tmmwiki.com/images/3/3f/GatewayBillerForm.pdf Gateway Biller Details Form]'''
  
 
== Basic Information ==
 
== Basic Information ==
Line 20: Line 21:
  
 
* Your TMMID (you must register for a TMMID at tmmid.com){{BL}}
 
* Your TMMID (you must register for a TMMID at tmmid.com){{BL}}
 +
 +
 +
* Your NATS version number: {{BL}}
  
  
Line 43: Line 47:
  
  
−
* How does your system identify members?: {{BL}}
+
* What transaction types do you support (for example: initial, credit, void)?: {{BL}}
  
 +
== Definitions ==
  
−
* What transaction types do you support (for example: initial, credit, void)?: {{BL}}
+
* transactionid -- a unique identifier for each transaction, created by your system
  
 +
* subscriptionid -- a unique identifier for each subscription, created by your system
  
−
== Required Fields and Definitions ==
+
* transaction reference id -- for credits, chargebacks, and reversals. The identifier for the original transaction being credited/etc.
  
−
* transactionid -- a unique identifier for each transaction
+
* passthrough variable -- a variable we can use to pass custom information, which will be included with initial transactions (for postbacks and/or polling).
  
−
* subscriptionid -- a unique identifier for each subscription
+
* instant upgrade -- an immediate upgrade from trial to full membership status. Force a rebill to occur now, instead of the end of the initial period.
  
−
* transaction reference id -- for credits, chargebacks, and reversals. The identifier for the original transaction being credited/etc.
+
* cross sell -- a sale to a different site, that is made at the time of the initial signup.
  
−
* passthrough variable -- a variable we can use to pass custom information, which will be included with initial transactions.
+
* upsell -- a sale to a different site, that is made after the initial signup. Upsells happen without requiring the credit card number.
  
 
== Gateway Communication ==
 
== Gateway Communication ==
  
 +
What method does NATS use to communicate with your system (ex: https post, xml, SOAP)
 +
{{BL}}
  
−
* What fields must NATS send to process an initial transaction?: {{BL}}
 
  
 +
What is the url we need to communicate with? {{BL}}
  
−
* Which field should NATS use for our passthrough variable?: {{BL}}
 
  
 +
Please list what fields we can send to your system for initial transactions, and whether they are required by your system
  
−
* In your response, how do we identify approved transactions?: {{BL}}
+
{| border="1"
 +
|Field                     
 +
|Required             
 +
|Type             
 +
|Max Length             
 +
|Description                                                                                    
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
| 
 +
|}
  
 +
Required fields for the post sent:
 +
* passthrough variable.
  
−
* In your response, which field contains the transactionid?: {{BL}}
 
  
 +
Please list what fields are returned in your response
  
−
* In your response, which field contains the subscriptionid?: {{BL}}
+
{| border="1"
 +
|Field                     
 +
|Description                                                                                    
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
  
 +
|}
  
−
* In your response, which field contains the amount?: {{BL}}
 
  
 +
Required fields for the response:
  
−
* In your response, which field contains the currency (required for multi-currency support)?: {{BL}}
+
* transactionid
−
 
+
* subscriptionid (for recurring subscriptions)
 +
* amount
 +
* currency (required for multi-currency support)
  
 
== Notification of Initial, Rebill, Credit, and Chargeback Transactions ==
 
== Notification of Initial, Rebill, Credit, and Chargeback Transactions ==
Line 102: Line 210:
 
=== 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 answer the following questions:
+
postback, please fill in the following table with the fields sent:
  
 +
{| border="1"
 +
|Field                     
 +
|Description                                                                                    
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|}
  
−
* What fields are contained in the postback?: {{BL}}
+
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:
  
−
* What types of transactions will be posted (example: rebill, return/credit, cancel, expire)?: {{BL}}
+
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.
  
  
−
* How should NATS identify the transaction type?: {{BL}}
+
For example, a url like this:
 +
https://example.com/ip_list.txt
  
 +
Which contains:
 +
1.2.3.4|1.2.3.5|1.2.3.6|1.2.3.7
  
−
* How can NATS identify approved transactions?: {{BL}}
 
  
 +
URL: {{BL}}
  
−
* Which field contains our passthrough variable (if posting initials)?: {{BL}}
 
  
 +
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? {{BL}}
  
−
* Which field contains the transactionid?: {{BL}}
 
  
−
 
+
=== Transaction Notification Using a Poll to a Reporting Script ===
−
* Which field contains the subscriptionid?: {{BL}}
+
If you elect to let NATS get information about transactions by accessing
−
 
+
a reporting script, please fill in the following information.
−
 
 
−
* Which field contains the amount?: {{BL}}
 
  
  
−
* Which field contains the currency (required for multi-currency support)?: {{BL}}
+
What is the URL of the reporting script? {{BL}}
  
  
−
== IP Addresses (for postbacks only) ==
+
What is the format of the reporting script (csv, xml, SOAP)? {{BL}}
−
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: {{BL}}
+
Please list the fields that should be sent to the reporting script:
  
 +
{| border="1"
 +
|Field                     
 +
|Required               
 +
|Type               
 +
|Description                                                                                    
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
| 
 +
| 
 +
|}
  
−
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? {{BL}}
+
Please fill in the following table with the fields returned for each transaction:
  
 +
{| border="1"
 +
|Field                     
 +
|Description                                                                                    
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|-
 +
| 
 +
| 
 +
|}
  
−
=== Transaction Notification Using a Poll to a Reporting Script ===
+
Required fields:
−
If you elect to let NATS get information about transactions by accessing
+
Fields required by NATS:
−
a reporting script, please answer the following questions:
+
* 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)
 +
* Date
  
  
−
* What fields are contained in the response?: {{BL}}
+
Are there any restrictions on the reporting (ie: date range or frequency)?:  
  
 +
{{BL}}
  
−
* What types of transactions will be reported (example: rebill, return/credit, cancel, expire)?: {{BL}}
+
== Instant Upgrades (Optional) ==
 +
<br />
  
 +
Does your system support instant upgrades?: {{BL}}
  
−
* How should NATS identify the transaction type?: {{BL}}
 
  
  
−
* How can NATS identify approved transactions?: {{BL}}
+
What is the format of the post (ie https post, XML, SOAP, etc)? {{BL}}
  
  
−
* Which field contains our passthrough variable (if reporting initials)?: {{BL}}
+
Please list what fields we can send to your system for instant upgrades, and whether they are required by your system
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Required&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Max Length&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|}
  
−
* Which field contains the transactionid?: {{BL}}
 
  
  
−
* Which field contains the subscriptionid?: {{BL}}
+
Please list what fields are returned in your response
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
  
−
* Which field contains the amount?: {{BL}}
+
|}
  
  
−
* Which field contains the currency (required for multi-currency support)?: {{BL}}
+
Required fields for the response:
  
 +
* Instant upgrade approval (yes or no)
  
−
* Are they any restrictions on the reporting (ie: date range or frequency)?: {{BL}}
+
== Cross Sells and Upsells (Optional) ==
  
  
 +
Do you want to support cross sells?: {{BL}}
  
−
== Instant Upgrades (Optional) ==
 
−
<br />
 
  
−
Does your system support instant upgrades?: {{BL}}
+
Do you support cross sells across accounts, or only between sites on the same account? {{BL}}
  
  
−
If your system does support instant upgrades, it must send a postback to
+
Do you have a system for cross sells, or do we send another initial? {{BL}}
−
NATS. Please answer the following questions about the instant
 
−
upgrade postback:
 
  
  
−
* What fields are contained in the postback?: {{BL}}
+
If you have a system for cross sells:
  
  
−
* How can NATS identify approved transactions?: {{BL}}
+
Please list what fields we can send to your system for cross sell transactions, and whether they are required by your system
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Required&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Max Length&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|}
  
−
== Cross Sells and Upsells (Optional) ==
+
Required fields for the post sent:
 +
* passthrough variable.
  
  
−
Does your system support cross sells?: {{BL}}
+
Please list what fields are returned in your response
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
  
−
Does your system support upsells?: {{BL}}
+
|}
  
  
−
If you system supports cross sells, upsells, or both, please answer the
+
Required fields for the response:
−
following questions:
 
  
 +
* transactionid
 +
* subscriptionid (for recurring subscriptions)
 +
* amount
 +
* currency (required for multi-currency support)
  
−
* What fields should NATS send to you?: {{BL}}
 
  
  
−
* What field should NATS use to send the passthrough variable?: {{BL}}
+
Do you support Upsells?: {{BL}}
  
  
−
Your system must return the cross sell status to the NATS process
+
Do you support upsells across accounts, or only between sites on the same account? {{BL}}
−
script. 
 
  
  
−
* What fields will you send to the process script?: {{BL}}
+
Do you have a system for upsells, or do we send another initial? {{BL}}
  
  
−
* Which field contains the NATS passthrough variable?: {{BL}}
+
If upsells use the normal initial system, how do we perform a sale without the credit card number? {{BL}}
  
  
−
== Gateway Communication ==
+
If you have a system for upsells:
  
  
−
* What fields must NATS send to your transaction form?: {{BL}}
+
Please list what fields we can send to your system for upsell transactions, and whether they are required by your system
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Required&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Max Length&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|&nbsp;
 +
|}
  
−
* Which field should NATS use to send the price?: {{BL}}
+
Required fields for the post sent:
 +
* passthrough variable.
  
  
−
* In your response, how do we identify approved transactions?: {{BL}}
+
Please list what fields are returned in your response
  
 +
{| border="1"
 +
|Field&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|Description&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
 +
|-
 +
|&nbsp;
 +
|&nbsp;
  
−
* In your response, which field contains the transaction identifier?: {{BL}}
+
|}
  
  
−
* In your response, which field contains the subscription identifier?: {{BL}}
+
Required fields for the response:
  
 +
* transactionid
 +
* subscriptionid (for recurring subscriptions)
 +
* amount
 +
* currency (required for multi-currency support)
  
 
== Other Special Features ==
 
== Other Special Features ==

Latest revision as of 11:13, 3 May 2022

Please email your your answers to this questionnaire, your full integration document, your testing account information, and your test purchase information to cho@toomuchmedia.com.

Find a PDF copy of this file here: Gateway Biller Details Form

Basic Information


  • Company Name:


  • Your name:


  • Your email:


  • Your phone number:


  • Your TMMID (you must register for a TMMID at tmmid.com)


  • Your NATS version number:


  • 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)?:

Definitions

  • transactionid -- a unique identifier for each transaction, created by your system
  • subscriptionid -- a unique identifier for each subscription, created by your system
  • 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 (for postbacks and/or polling).
  • instant upgrade -- an immediate upgrade from trial to full membership status. Force a rebill to occur now, instead of the end of the initial period.
  • cross sell -- a sale to a different site, that is made at the time of the initial signup.
  • upsell -- a sale to a different site, that is made after the initial signup. Upsells happen without requiring the credit card number.

Gateway Communication

What method does NATS use to communicate with your system (ex: https post, xml, SOAP)


What is the url we need to communicate with?


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:

  1. Your system sends NATS a postback.
  2. 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.


For example, a url like this: 

https://example.com/ip_list.txt

Which contains: 

1.2.3.4|1.2.3.5|1.2.3.6|1.2.3.7


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 fill in the following information.


What is the URL of the reporting script?


What is the format of the reporting script (csv, xml, SOAP)?


Please list the fields that should be sent to the reporting script:

Field                      Required                Type                Description                                                                                    
       
       
       
       
       
       
       

Please fill in the following table with the fields returned for each transaction:

Field                      Description                                                                                    
   
   
   
   
   
   
   
   
   
   
   
   
   
   
   

Required fields: 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)
  • Date


Are there any restrictions on the reporting (ie: date range or frequency)?:

Instant Upgrades (Optional)


Does your system support instant upgrades?:


What is the format of the post (ie https post, XML, SOAP, etc)?


Please list what fields we can send to your system for instant upgrades, and whether they are required by your system

Field                      Required              Type              Max Length              Description                                                                                    
         
         
         
         
         
         
         
         
         


Please list what fields are returned in your response

Field                      Description                                                                                    
   
   
   
   
   
   
   
   
   
   
   


Required fields for the response:

  • Instant upgrade approval (yes or no)

Cross Sells and Upsells (Optional)

Do you want to support cross sells?:


Do you support cross sells across accounts, or only between sites on the same account?


Do you have a system for cross sells, or do we send another initial?


If you have a system for cross sells:


Please list what fields we can send to your system for cross sell 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)


Do you support Upsells?:


Do you support upsells across accounts, or only between sites on the same account?


Do you have a system for upsells, or do we send another initial?


If upsells use the normal initial system, how do we perform a sale without the credit card number?


If you have a system for upsells:


Please list what fields we can send to your system for upsell 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)

Other Special Features

Do you have any special features not addressed by this document?:

If you answered yes, please describe the special features below.




Retrieved from "https://tmmwiki.com/index.php?title=Gateway_Biller_Details_Query_Letter&oldid=29618"