Add clarification to notes_for_module_writers_v3 on authorization vs. order_number

diff --git a/Changes b/Changes
index a4255e8..a09270f 100644 (file)
--- a/Changes
+++ b/Changes
@@ -7,6 +7,8 @@ Revision history for Perl extension Business::OnlinePayment.
           cvv2_response, response_code, response_headers, response_page.
         - Add beginning of introspection interface for processor modules.
         - Add electronic check fields to documentation: bank_city, bank_state
+        - Add clarification to notes_for_module_writers_v3 on authorization vs.
+          order_number
 
 3.00     Mon Aug 17 15:55:11 PDT 2009
         - It finally happened.

diff --git a/notes_for_module_writers_v3 b/notes_for_module_writers_v3
index 6b98a3b..d5d9834 100644 (file)
--- a/notes_for_module_writers_v3
+++ b/notes_for_module_writers_v3
@@ -95,3 +95,16 @@ These are the module writer's notes for v3.  See the regular
       }
 
 
+- authorization and order_number (NEWLY DOCUMENTED IN 3.01):
+
+  Gateways will return one or two values from Authorization Only and
+  Normal Authorization transactions that must be submitted back with a
+  Post Authorization, Void, or Credit transaction.
+
+  If the gateway returns one value, return this as "authorization"
+
+  If the gateway returns two values, return one as "authorization" and the
+  other as "order_number".  Typically "authorization" is the more low-level
+  value returned from the underlying processing network while "order_number"
+  is a unique tranaction id generated by the gateway.
+