BYbyaccrue
Simulations

Create Demo Backup Payment Method

Create a demo backup payment method (linked account) for a wallet in testing environments.

This endpoint simulates linking a bank account to a wallet for backup payment purposes without requiring actual bank account credentials or Plaid integration.

The created linked account can be used as a backup payment method for transactions when the primary funding source is insufficient.

This endpoint is only available in development, sandbox, and local testing environments.

The testCardType parameter is optional and allows you to specify which type of test card to simulate. If not provided, a default test card type will be used.

post/api/v1/simulation/wallets/{walletId}/backup-linked-account

Request

Path parameters

walletIdstring uuid required

Wallet ID

Example:123e4567-e89b-12d3-a456-426614174000

Headers

Client-IDstring uuid required

The unique identifier of the client making the request. This header is required to retrieve the client-specific configuration and ensure that the response is tailored to the client's settings and permissions.

Example:123e4567-e89b-12d3-a456-426614174000
Authorizationstring uuid required

Secure secret to access privileged endpoints.

Example:Bearer 633b336e4f57f095a405f6685e208cc7dd16de3e82494662f2acfeec3af1cdef

Request body

testCardType'visa-us-credit' | 'visa-gb-credit' | 'visa-gb-debit' | 'mastercard-mu-credit' | 'mastercard-de-debit'

Test card type from Checkout.com that returns response code 10000 (successful transaction)

Example request

{
  "testCardType": "visa-us-credit"
}

Response

Successfully created demo backup payment method

Example response

{
  "data": {
    "attributes": {
      "linkedAccountId": "123e4567-e89b-12d3-a456-426614174000",
      "accountMask": "1234",
      "institutionName": "Test Bank",
      "accountType": "checking",
      "status": "active"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.