Support captures and capturing in context of BNPL(buy now pay later processes).

[gadimbaylisahil]

Problems

1. When creating an invoice payment, the state stays in pending. This invoices has to be captured manually by the merchants.

2. Some merchants wants their invoices to be captured when state of the shipping changes to shipped(or whatever is the term in shopware 6).

Solution

1. Provide a captures card for order just like we have for refunds.

• Captures should only be allowed for Invoice B2C and B2B transactions for now.
• Captures should be done using endpoint mentioned https://dashboard.betterpayment.de/docs/#capture-api
• Capture endpoint should receive amount parameter(amount of the transaction)
• Capture endpoint should receive comment parameter (in automatic system, it should be Captured using Shopware 6 plugin)
• Capture endpoint should receive comment parameter(in manual system, this can be entered in a text field by the merchant, default should be captured using Shopware 6 plugin)
• Same information messages should exist in Captures card, just like we have to refunds.
• List of captures can be acquired from transactions#log endpoint just like we have for refunds.

2. Configuration option in Invoice B2C and B2B payment methods separately

Configuration option should be named:

• automatically_capture_transaction_when_order_is_shipped

Configuration option should have informative text:

When order's shipping state changes to shipped, plugin will automatically capture the order's transaction in API. You can also capture transactions manually, by turning this flag off.

Unclear parts

What happens when order is shipped partially? Do we calculate shipped products' amounts and send capture request with that amount?

This only applies to automatic capturing. Manual captures are in control of merchants anyway.

How to capture?

1. Create an Invoice B2C or Invoice B2B transaction.
2. Transaction will now be in pending state.
3. Only autorized, pending or completed state transactions can be captured. Over captures are possible.
4. Capture the transaction with an amount.
5. Expect successful result
6. Transaction #show request now should contain captured amount.

[hasanzade-hasan]

Following is result of call with Neeme.

Creating an invoice calls capture with:

• invoice_id (new param)
• execution_date (old param, we'll use that for invoice date)
• amount (old param)

The rest of the magic will happen inside the BP API. Crefo wants to know the payment period / due date, but since Shopware doesn't keep track of that, we'll store the value in our dashboard for the first version.