Choose Transaction Type
Last updated: March 10th 2022, @ 3:39:25 pm
The primary transaction types available to Payflow Pro users are authorizations, delayed captures, sale, and void transactions, and credit/refund transactions.
These examples show basic requests and responses. For more transaction types and examples, see Submitting Credit Card Transactions.
- Authorization Transaction
- Delayed Capture Transaction
- Sale Transaction
- Void Transaction
- Credit or Refund Transaction
Authorization transaction
An authorization transaction places a hold on the cardholder's available fund limit, lowering the cardholder's limit by the amount of the transaction. An authorization transaction does not transfer funds.
Request
To perform an authorization, pass the TRXTYPE=A
parameter along with the required connection, user, and credit card transaction parameters to the appropriate endpoint.
USER=XXXXXX&VENDOR=XXXXXXXX&PARTNER=PayPal&PWD=XXXX&TRXTYPE=A&TENDER=C&ACCT=4xxxx&EXPDATE=xxxx&CVV2=xxx&AMT=1.00&INVNUM=521aa62355f5eb5515eca3777e1f8b78&PONUM=PFDCCTEST&COMMENT1=Test Comment 1&COMMENT2=Test Comment2&VERBOSITY=HIGH&BILLTOFIRSTNAME=Frank
&BILLTOLASTNAME=Enstien&BILLTOSTREET=123 Main St.&BILLTOSTREET2=Suite 267&BILLTOCITY=GILBERT
&BILLTOSTATE=AZ&BILLTOZIP=85298&INVNUM=InvoiceNumber001&CUSTOM=CustomNumber001
Response
RESULT=0&PNREF=B10P4FFEB1AD&RESPMSG=Approved&AUTHCODE=111111&AVSADDR=Y&AVSZIP=Y&CVV2MATCH=Y&PPREF=28X110156B855103Y&CORRELATIONID=8460f71a9c548&PROCAVS=X&PROCCVV2=M&TRANSTIME=2013-08-1310:03:54&BILLTOFIRSTNAME=Frank&BILLTOLASTNAME=Einstein&AMT=1.00&ACCT=7271&EXPDATE=1220&CARDTYPE=0&IAVS=N&PREFPSMSG=NoRulesTriggered&POSTFPSMSG=No Rules Triggered
Note: For authorization and sale transactions, the
INVNUM
andCUSTOM
parameters send unique identifiers for each transaction. If PayPal is your payments processor, these are displayed in your PayPal reports. You can also include theCOMMENT1
andCOMMENT2
parameters to append useful information for each transaction.
Delayed capture transaction
Perform a delayed capture transaction after an authorization transaction to capture the authorization amount to be collected during the net settlement period.
Request
To perform a delayed capture, pass TRXTYPE=D
and ORIGID
(the ID of the original transaction referenced) along with the required connection, user, and credit card transaction parameters to the appropriate endpoint.
Optionally, if you process payments through PayPal, you can include the CAPTURECOMPLETE
parameter. This indicates whether the delayed capture transaction is the last capture you intend to make. Valid values are Y
(default) or N
. If CAPTURECOMPLETE=Y
is passed, any remaining amount of the original reauthorized transaction is automatically released.
USER=XXXXXX&VENDOR=XXXXXXXX&PARTNER=PayPal&PWD=XXXX&TRXTYPE=D&TENDER=C&AMT=1.00&ORIGID=B10P4FFEB1AD&CAPTURECOMPLETE=Y&VERBOSITY=HIGH
Response
The PNREF
parameter returns the ORIGID
.
RESULT=0&PNREF=A71AA1A79003&RESPMSG=Approved&AUTHCODE=527PNI&AVSADDR=Y&AVSZIP=Y
&CVV2MATCH=Y
Sale transactions
Sale transactions charge the specified amount against the account and marks the transaction for immediate fund transfer during the next settlement period.
Request
To perform a sale transaction, pass the TRXTYPE=S
parameter along with the required connection, user, and credit card transaction parameters to the appropriate endpoint.
USER=XXXXXX&VENDOR=XXXXXXXX&PARTNER=PayPal&PWD=XXXX&TRXTYPE=S&TENDER=C&ACCT=4xxxx&EXPDATE=xxxx&CVV2=xxx&AMT=1.00&INVNUM=521aa62355f5eb5515eca3777e1f8b78&PONUM=PFDCCTEST&COMMENT1=Test Comment 1&COMMENT2=Test Comment2&VERBOSITY=HIGH&BILLTOFIRSTNAME=Frank
&BILLTOLASTNAME=Enstien&BILLTOSTREET=123 Main St.&BILLTOSTREET2=Suite 267&BILLTOCITY=GILBERT
&BILLTOSTATE=AZ&BILLTOZIP=85298&INVNUM=InvoiceNumber001&CUSTOM=CustomNumber001
Response
RESULT=0&PNREF=B10P4FFEB1AD&RESPMSG=Approved&AUTHCODE=111111&AVSADDR= Y&AVSZIP=Y
&CVV2MATCH=Y&PPREF=28X110156B855103Y&CORRELATIONID=8460f71a9c548& PROCAVS=X
&PROCCVV2=M&TRANSTIME=2013-08-13 10:03:54&BILLTOFIRSTNAME=Frank& BILLTOLASTNAME=Einstein
&AMT=1.00&ACCT=7271&EXPDATE=1220&CARDTYPE=0&IAVS=N& PREFPSMSG=No Rules Triggered
&POSTFPSMSG=No Rules Triggered
Void transaction
A void transaction prevents the capture of authorized funds from being settled. You can only void transactions that have not yet settled.
Request
To perform a void transaction, pass the TRXTYPE=V
and ORIGID
parameters along with the required connection, user, and credit card transaction parameters to the appropriate endpoint.
USER=XXXXXX&VENDOR=XXXXXXXX&PARTNER=PayPal&PWD=XXXX&TRXTYPE=V&TENDER=C
&AMT=1.00&ORIGID=B10P4FFEB1AD&CAPTURECOMPLETE=Y&VERBOSITY=HIGH
Response
RESULT= 0&PNREF= B70P4EBC54B7&RESPMSG= Approved&PPREF= 5GY89824G17878310&
CORRELATIONID= fde19f9e30d73
Credit or refund transaction
Credit or refund transactions refund a specified amount back to the cardholder.
Request
To perform a credit or refund transaction, pass the TRXTYPE=C
and ORIGID
parameters along with the required connection and user parameters. To refund an amount that is less than the amount that was originally charged, specify the AMT
parameter.
USER=XXXXXX&VENDOR=XXXXXXXX&PARTNER=PayPal&PWD=XXXX&TRXTYPE=C&TENDER=C&AMT=1.00&ORIGID=B1PP4FFEBD85&VERBOSITY=HIGH
Response
RESULT=0&PNREF=B1PP4FFEBD89&RESPMSG=Approved&PPREF=7DY60282G2735230J&CORRELATIONID=fde19f9e30d73
Next
Learn how to test transactions.