Skip to content
/
Confirm payment

Confirm payment

Request

This endpoint is used for payment methods that require a multi-step payment flow. It allows you to confirm a previously created payment instance (initiated via the Create Payment endpoint) to complete the transaction. This step is essential for certain payment methods to finalize the payment process.

Security
bearer and basic and apiKey
Path
idstringrequired

PayId assigned by Computop Paygate in the initial request

Headers
Idempotency-Keystring

A unique key provided by you to ensure that a particular operation is not processed multiple times in case of retries.

Bodyapplication/jsonrequired
transIdstring, <= 64 charactersrequired

Transaction ID created in your system. It should be unique for each payment.

amountobject(amount)required
refNrstring

Your unique reference number for the specific operation. You can pass this value to reconcile different operations in a payment (authorization, capture, refund, etc) individually. It is recommended to limit the length to 18 characters so that it works for all payment methods. Allowed characters: (A-Z, a-z) and digits (0-9)

captureMethodobject(captureMethod)
expirationTimeany, (date-time)

Transaction expiry timestamp (UTC).

orderobject(order)
metadataobject

A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs passed by you. Paygate will return the data as it is in the response.

billingAddressobject(billingAddress)
shippingobject(shipping)
credentialOnFileobject(credentialOnFile)
paymentMethodsobject(paymentConfirm)
curl -i -X POST \
  -u '<username>:<password>' \
  'https://test.computop-paygate.com/api/v2/payments/{id}/confirms' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "transId": "6B29FC40-1067-B31D-00DD010662DA",
    "amount": {
      "value": 10000,
      "currency": "EUR"
    },
    "refNr": "24235345432",
    "captureMethod": {
      "type": "AUTOMATIC"
    },
    "order": {
      "merchantReference": "112-445-34567",
      "numberOfArticles": 1,
      "creationDate": "2025-03-31T11:58:37Z",
      "invoiceId": "555-333-2222",
      "items": [
        {
          "id": "1",
          "sku": "19-402-DEU",
          "name": "BatteryPowerPack",
          "quantity": 1,
          "quantityUnit": "pcs",
          "taxRate": 0,
          "netPrice": 1000,
          "grossPrice": 1000,
          "taxAmount": 0,
          "discountAmount": 0,
          "description": "BatteryPowerPack",
          "type": "physical",
          "productInfo": {
            "brand": "Intel",
            "categories": [
              "Electronics Store",
              "Computers",
              "Desktops"
            ],
            "globalTradeItemNumber": "EAN",
            "manufacturerPartNumber": "BOXNUC5CPYA",
            "imageUrl": "https://www.exampleobjects.com/logo.png",
            "productUrl": "https://www.estore.com/products/f2a8d7e34"
          }
        }
      ]
    },
    "paymentMethods": {
      "card": {
        "eventToken": "ORDER"
      }
    }
  }'

Responses

Successful operation

Bodyapplication/json
payIdstring

A unique identifier assigned by Computop Paygate to the payment. This ID remains constant throughout the lifecycle of the payment and is used to track and reference the payment across all subsequent operations, such as authorization, capture, refund, or cancellation.

merchantIdstring

Merchant ID assigned by Computop Paygate.

transIdstring

Transaction ID provided by you in the request.

xIdstring

A unique identifier assigned by Computop Paygate for each operation in the payment. For example: xId will be different for the authorization and capture operations of a payment whereas payId will be same.

refNrstring

Reference number provided by you in the request.

statusstring

Status of the transaction.

responseCodestring

Response code of the transaction.

responseDescriptionstring

Response description associated with the response code.

metadataobject

A collection of additional custom data provided by you to store extra information about the transaction. This is a set of JSON key value pairs as you passed in the request.

orderobject(order)
customerInfoobject(customerInfo)

Information about the customer.

paymentMethodsobject(paymentConfirmResponse)
Response
{
  "merchantId": "merchant-test",
  "payId": "6c7c66e5352241c19d82c175a01f713a",
  "xId": "93c4093c6d3644fcb6c60484f7a831fd",
  "transId": "98582271-63d2-4b90-9422-5fb597a4c41d",
  "status": "OK",
  "responseCode": "00000000",
  "responseDescription": "success",
  "order": {
    "invoiceId": "ABC123",
    "merchantReference": "XYZ123"
  },
  "customerInfo": {
    "merchantCustomerId": "XXX123"
  }
}