These developer docs are now deprecated and will not contain updated information that you may need to reference, including latest release versions. If you wish to see the current developer docs, please visit developers.braintreepayments.com.

Transaction Overview with Perl

Statuses

Authorized

The processor authorized the transaction. Your customer may see a pending charge on his or her account. However, before the customer is actually charged and before you receive the funds, you must submit the transaction for settlement. If you do not want to settle the transaction, you should void it to avoid a misuse of authorization fee.

Authorization Expired

The transaction spent too much time in the Authorized status and was marked as expired. American Express authorizations will be marked as expired after 7 days. Visa and Mastercard authorizations will be marked as expired after 10 days. All other authorizations will be marked as expired after 30 days.

Processor Declined

The processor declined the transaction. The processor response code has information about why the transaction was declined.

Gateway Rejected

Failed

An error occurred when sending the transaction to the processor.

Voided

The transaction was voided. You can void transactions when the status is authorized or submitted for settlement. After the transaction has been settled, you will have to refund the transaction instead.

Submitted for Settlement

The transaction has been submitted for settlement and will be included in the next settlement batch. Settlement happens nightly — the exact time depends on the processor.

Settling

The transaction is in the process of being settled. This is a transitory state. A transaction cannot be voided once it reaches settling status, but can be refunded.

Settled

The transaction has been settled.

Escrow Statuses

Pending Hold

The transaction will be held in Escrow once Settled.

Held in Escrow

The transaction has settled and is now held in Escrow and eligible to be Released.

Pending Release

The transaction being held in Escrow will be released and disbursed shortly.

Released

The transaction that was being Held in Escrow has been released.

Refunded from Escrow

The transaction that was being held in Escrow has been refunded. Only full refunds are allowed for Escrow transactions.

US & Canada

Europe

UK

Australia

Add the following text to your marketplace's Terms of Service. Don't forget to replace [MSP] with your marketplace's name.

[MSP NAME] uses Braintree, a division of PayPal, Inc. (Braintree) for payment processing services. By using the Braintree payment processing services you agree to the Braintree Payment Services Agreement available at https://www.braintreepayments.com/legal/gateway-agreement, and the applicable bank agreement available at https://www.braintreepayments.com/legal/cea-wells. If you have questions regarding the MSA, please contact Braintree at 877.434.2894.