BaaS Card Sandbox

Triggering Card Payment Events in Sandbox

This guide describes how to simulate Card Payment events—specifically, Authorization and Financial Transaction (Capture)—in the ConnectPay Sandbox environment.

Preconditions

Before triggering any card transaction events, ensure the following conditions are met:

  1. Activated Card
    • A card application has been successfully approved.
    • An active card is available (parameter cardId will be needed).
  2. Activated Account
    • The account linked to the card is open and active.
    • An IBAN is created and available.
  3. Sufficient Balance
    • The account must have enough available funds to cover the transaction amount (for both reservation and completion steps).

Step 1: Create Card Authorization (Reservation)

This step simulates the authorization request stage of a card payment, where the amount is reserved on the account.

Endpoint: POST /sandbox/ob/cards/{cardId}/authorizations

Request Body: recommended values for test case

{
    "cardTransactionType": "AUTHORISATION_REQUEST",
    "serviceType": "CARD_PURCHASE",
    "transactionAmount": {
        "amount": "1.00",
        "currency": "EUR"
    },
    "originalAmount": {
        "amount": "1.00",
        "currency": "EUR"
    },
    "purchaseDatetime": "2025-10-31T05:22:30.000Z",
    "merchant": {
        "name": "Cards Automation Test",
        "address": {
            "city": "Vilnius",
            "postcode": "65666",
            "addressLine1": "Street name 13",
            "countryCode": "LT"
        },
        "categoryCode": "123123"
    }
}

Expected Results:

  • A webhook notification is triggered, containing the Transaction ID and Card ID.
  • A reservation (card hold) is created on the associated account.

Step 2: Capture (Complete the Transaction)

Once the authorization is created, one can simulate the financial transaction stage by capturing the previously authorized amount.
This finalizes the payment and releases the reserved funds.

Endpoint: POST /sandbox/ob/cards/{cardId}/captures

Request Body: recommended values for test case

{
    "serviceType": "CARD_PURCHASE",
    "authorization": {
        "cardTransactionId": "{{cardTransactionIdFromAddHoldResponseBody}}"
    },
    "transactionAmount": {
        "amount": "1.00",
        "currency": "EUR"
    },
    "originalAmount": {
        "amount": "1.00",
        "currency": "EUR"
    },
    "purchaseDatetime": "2025-10-31T05:22:30.000Z",
    "merchant": {
        "name": "Cards Automation Test",
        "address": {
            "city": "Vilnius",
            "postcode": "65666",
            "addressLine1": "Street name 13",
            "countryCode": "LT"
        },
        "categoryCode": "123123"
    }
}

Expected Results:

  • The card payment is successfully completed.
  • The transaction is now added in the Account Transaction List API.

Notes:

  • Only EUR currency values are supported.
  • The merchant address can be modified for testing purposes.
  • All fields in the Authorization and Capture requests must match, except for the amount (if testing partial captures).
  • The sequence must follow: Authorization → Capture
  • If done successfully Authorization triggers Card Payment Status Chage notification
  • If done successfully Capture triggers Balance movement, and Card transaction on selected Account and can be retrieved by Get Account Transactions request

Scroll to Top