transaction ids in getpaid

[David Glick]

I have an event handler for the transition when the finance workflow
is charged, and want it to do something with the transaction ID from
the payment processor (authorize.net in this case). However I'm
getting confused because there are several different transaction id
variables that don't seem to be getting used consistently...

- The authorize.net processor records the transaction ID from
authorize.net in an annotation on the order called
'getpaid.processor.uid' (the annotation key is based on the value of
getpaid.core.interfaces.keys.processor_txn_id)

- Order instances have a 'user_payment_info_trans_id' attribute and a
setOrderTransId method for setting it, but this doesn't appear to be
called by the authorize.net processor.

- I'm actually trying to use getpaid.SalesforcePloneFormGenAdapter to
record the transaction id to Salesforce. It knows about a field which
it calls "Transaction ID" when configuring the mapping of fields to
Salesforce, but whose value is actually looked up in the
'processor_order_id' attribute of the order. That attribute is
initialized to None for the class and doesn't appear to get set
anywhere.

Can anyone give any insight into whether this reality exists for some
particular reason or whether it is just a mess that needs to be
cleaned up? And if the latter, any insight into what is the "correct"
place to store this value on the order?

thanks,
David