Capturing Customer Payments

Barkpass offers different ways to capture customer payments in relation to the pass approval flow:

• Capture Immediately (default)
• Capture on Approval
• Capture Offline

Payment behavior is defined on the pass level and can be modified by visiting your Pass settings > Pass Prices section.

Capture Immediately

By default, Barkpass will capture funds from customer credit cards immediately upon checkout. This means the customer's funds are debited from their account while their application is sitting in the "Pending" status.

You can still refund part or all of the transaction if the purchase was made in error.

Capture on Approval

In some cases, you may wish to refrain from capturing funds until you have approved the application. This could be useful if you find that customers are purchasing the incorrect pass or often select the incorrect price level and frequently require refunds.

When the pass's payment behavior is set to "Capture on Approval," the customer's card is authorized for the total price of their application at checkout but is not yet charged.

Then, when you approve the application, their authorization is captured and the card is charged for the authorized amount.

Capture Offline

If you wish to allow customers to apply for passes that cost money but collect that money at a later date, for instance in person on the day of arrival, you can select the "Capture Offline" method.

The customer will simply be prompted to "Submit Application" once they've met the requirements of the pass. This will send mark their application as Pending rather than sending them to checkout.

You can capture the payment manually by visiting the application in your Barkpass admin and clicking "Capture Payment" at any time.

Limitations and Considerations

• Card authorizations are valid for seven (7) days. This means you have seven days to either approve the application, or request changes from the customer and wait for their response before finally approving it.
• You can optionally capture the payment manually if you wish to capture the funds without approving the application. See "Manual Captures" below.
• You can view the payment authorization status and expiration deadline under "Payment Information" in the application from the Barkpass admin.
• You can opt-in to notifications when payment authorizations are going to expire by visiting your Barkpass profile settings and enabling the "Authorization Expiring Soon" notification. This will send you a notification two days before an authorization is about to expire, prompting you to take action.
• Canceling an application will cancel any payment authorizations attached to it. This is useful if the customer has applied for a pass in error — no money has been exchanged, and no refunds are necessary.
• Capture on Approval is not supported for recurring passes or memberships. The only capture behavior supported for recurring memberships is Capture Immediately.

Manual Captures

To manually capture an authorized payment, visit the application detail page in the Barkpass admin and scroll to the "Payment Information" section.

Open the three dot menu at the top right, and select "Capture Payment."

This will capture the funds immediately and create a transaction for the application. This gives you time to request changes, etc before the seven-day window elapses.

Partial captures

Partial captures are not supported at the moment.

If a customer has purchased a pass with a price but the actual price is lower, you can either approve the payment and issue a partial refund, or cancel the application and ask the customer to apply again with the correct price.

What to do when authorizations expire

If the seven-day window has elapsed and a payment authorization has expired, you can collect payment from the customer by canceling the application.

The customer should visit your Barkpass landing page and apply for the same pass again, entering their payment information as normal.

Add-on passes with Capture on Approval behavior

When add-on passes are involved, only the behavior of the "primary" pass is respected.

For example, if a customer applies for a pass which is set to "Capture Immediately," their payment is captured immediately regardless of any add-on passes they are purchasing with the application.

If the primary pass uses "Capture on Approval," the authorization will be captured as soon as the first application is approved as part of the bundle, regardless of whether that pass uses the same setting.