Skip to content

Capture Funds

Use Capture to complete a previously initiated payment that has not already been captured, indicated by the capturable flag in the response. Payment method type Card and some e-wallets supports the authorize/capture flow, others are auto-captured by default.

By default, the full authorized amount will be captured.

1
2
3
4
5
curl -X POST \
  https://rest.payments.worldline.com/v2/merchants/1108852714/orders/exampleorder1/captures \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json'
  -H 'Authorization: Bearer 6f60933ddd9eb84dfbc5c1db1f51517a8b247ea1'
1
2
3
4
POST /v2/mid/1108852714/orders/exampleorder1 HTTP/1.1
Accept: application/json
Content-type: application/json
Authorization: Bearer 6f60933ddd9eb84dfbc5c1db1f51517a8b247ea1
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<CaptureOrderRequest>
    <OrderInfo>
        <OrderId>exampleorder1</OrderId>
    </OrderInfo>
    <RequestInfo>
        <TransactionChannel>Web Online</TransactionChannel>
    </RequestInfo>
    <MerchantInfo>
        <MerchantId>1108852714</MerchantId>
    </MerchantInfo>
</CaptureOrderRequest>

Referencing the Initiating transaction

With the Capture, you optionally refer to a previous transactionId. You must use the same mid and orderId as you used in the InitiatePayment method.

Partial and multiple captures

Some but not all payment methods support partial or multiple captures. Worldline support captures up to maximum 100% of the authorized amount in the standard client configuration. In some specific cases, up to 115% amount is allowed. Speak with your integrations manager if required.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
curl -X POST \
  https://rest.payments.worldline.com/v2/merchants/1108852714/orders/exampleorder1/captures \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 6f60933ddd9eb84dfbc5c1db1f51517a8b247ea1'
  -d '{
    "amount": {
        "currency": "EUR",
        "amount": 4.50
    }
}'
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
POST /v2/merchants/1262899477/orders/order1234/captures HTTP/1.1
Accept: application/json
Authorization: Bearer 6f60933ddd9eb84dfbc5c1db1f51517a8b247ea1
Content-Type: application/json

{
    "amount": {
        "currency": "EUR",
        "amount": 10
    }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
<CaptureOrderRequest>
    <OrderInfo>
        <OrderId>exampleorder1</OrderId>
    </OrderInfo>
    <RequestInfo>
        <TransactionChannel>Web Online</TransactionChannel>
        <TimeoutSeconds>45</TimeoutSeconds>
    </RequestInfo>
    <MerchantInfo>
        <MerchantId>1108852714</MerchantId>
    </MerchantInfo>
    <PayInfo>
        <Amount>1400</Amount>
        <Currency>
            <AlphabeticCode>SEK</AlphabeticCode>
        </Currency>
    </PayInfo>
</CaptureOrderRequest>