Choose Transaction Type

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

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 and CUSTOM parameters send unique identifiers for each transaction. If PayPal is your payments processor, these are displayed in your PayPal reports. You can also include the COMMENT1 and COMMENT2 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.

Additional information

Feedback