---
title: "Initiate Signing Basket."
method: POST
path: "/v1/signing-baskets/{id}/initiate"
tags: ["SigningBaskets"]
---

# Initiate Signing Basket.

`POST /v1/signing-baskets/{id}/initiate`

## Path parameters

- `id` string, required

## Headers

- `sessionId` string, uuid
- `authorizationId` string, uuid

## Request body

- SigningBasketInitiationRequest
  - `debtor` PaymentDebtor, required
    - `account` PaymentAccount, required
      - `accountNumber` string, required
      - `accountType` 'IBAN' | 'BBAN' | 'BG' | 'PG', required
      - `bic` string, nullable
      - `currencyCode` string, nullable
    - `message` string, nullable
    - `name` string, nullable
  - `redirectUri` string, nullable

## Response `200`

The request has been fulfilled and Signing Basket is initiated.

- SigningBasketResponse
  - `amount` number, double, required
  - `currency` string, required
  - `id` string, required
  - `paymentIds` string[], required
  - `scaMethods` ScaMethod[], nullable
    - `href` string, nullable — Redirect link for redirect or decoupled SCA methods.
    - `downloadLink` string, nullable — Download link used to get image that contains dynamic QR code. Supported formats: PNG.
    - `downloadInterval` integer, nullable — Download interval represents the period of changing the content of the downloadLink.
    - `scaMethodType` 'PSU_DECOUPLED' | 'PSU_REDIRECT', required — Strong customer authentication methods.
  - `status` 'CREATED' | 'RECEIVED' | 'CANCELED' | 'FAILED' | 'REJECTED' | 'AUTHORIZATION_REQUIRED' | 'IN_PROGRESS_CODE' | 'IN_PROGRESS' | 'AUTHORIZED' | 'COMPLETED' | 'DELETED', required

## Other responses

- `400` — Error caused by invalid or missing data.
- `401` — Authentication failed due to missing or invalid credentials.
- `403` — Error caused by user not permitted access to the resource.
- `404` — Endpoint does not exist or URL is not constructed correctly.
- `500` — Error caused by remote technical issues, this status code is used for unforeseen technical issues.
- `503` — Returned when service is unavailable due to scheduled reasons, such as maintenance.

---

[API](https://skmtc.net/finshark/apis/finshark-api.md) · [All operations](https://skmtc.net/finshark/apis/finshark-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finshark/finshark-api/revisions/7fc3b4f800ae/schema)