Skip to main content
POST
/
api
/
v1
/
embedded
/
payment-initiation
Initiate a payment for an embedded flow using payment_token (query or body) and selected bank
curl --request POST \
  --url https://core.quidkey.com/api/v1/embedded/payment-initiation \
  --header 'Content-Type: application/json' \
  --data '
{
  "bankId": "123e4567-e89b-12d3-a456-426614174000",
  "paymentScheme": null
}
'
{
  "success": true,
  "data": {
    "order_id": "123"
  }
}

Body

application/json

Request body

​
bankId
string<uuid>
required

The selected bank ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
paymentScheme

Payment scheme selected by user. null = use default scheme for customer country, explicit value = user choice

Allowed value: "SEPA_CREDIT_TRANSFER"
Example:

null

Response

Success

​
success
boolean
required

Indicates if the request was successful

Example:

true

​
data
Payment Initiation Data · object
required

Payment initiation response data