/v2/cards

  • Updated on Jan 13, 2026
  • Published on Oct 1, 2025
  • 1 minute(s) read
  • DN
  • SC
 Prev Next
Post
/v2/cards
Body parameters

HMAC Operation - card_create

object
program
string | null
Examplecard_eur
account
string | null
Examplea451c34e-56d7-4e7f-8b6c-3322791ea792
merchant
string | null

Required only for non pesonalized card in case must be assigned to merchant immediately.

Exampleb204ac3f-a23e-442b-a909-898238197070
user
string | null

Required only for non pesonalized card in case must be assigned to user immediately.

Exampleb204ac3f-a23e-442b-a909-898238197070
aml
string | null

Token of AML check. Conditinal: depending on program configuration

Exampleb204ac3f-a23e-442b-a909-898238197070
embossName
string | null
ExampleJohn Doe
embossNameLine4
string | null
ExampleJohnDoe Ltd
fulfil1
string | null
Example123456
fulfil2
string | null
Example789123
thermalLine1
string | null
Example123456
thermalLine2
string | null
Example789123
active
boolean | null
Examplefalse
pin
string | null
Example1234
type
string Required
Valid values[ "plastic", "virtual" ]
Examplevirtual
firstName
string | null
ExampleJohn
lastName
string | null
ExampleDoe
alias
string | null
ExampleShopping Card
deliveryDetails
OneOf
CardDeliveryDetailsRequestDto
object (CardDeliveryDetailsRequestDto)
city
string Required
ExampleSofia
country
string Required
ExampleBG
county
string | null
ExampleSofia Grad
zip
string Required
Example1407
address1
string Required
ExampleJames Bouchier 76A
address2
string | null
ExamplePaynetics Office
address3
string | null
ExampleFloor 2
method
string | null
code
string | null
mobilePhone
string | null
Example+3590000000
threeDomainEnrolment
OneOf
CardThreeDomainRequestDto2
object (CardThreeDomainRequestDto2)
otpSms
string Required
Example+3590000000
biometric
boolean | null
Exampletrue
url
string | null
Examplehttp://example.url
Responses
200

Success

Expand All
object
code
integer | null
Default0
Example0
data
OneOf
AccountDto
object (AccountDto)
program
string | null
Exampleaccount_eur
token
string | null
Example202f828a-c594-436d-b753-87c47556ef11
merchant
string | null
Example68f63588-2859-4997-8a23-29c59223e6ba
user
string | null
Example5eef34b5-69d8-4596-a9d3-b3aad500e825
type
string | null
Exampledefault
number
string | null
Example0123456789
linkKey
string | null
Example1234
isMain
boolean | null
Exampletrue
status
string | null
Exampleactive
multicurrency
boolean | null
Examplefalse
balances
Array of object (BalanceDto) | null
object
available
number (float) | null
Example1.23
blocked
number (float) | null
Example1.23
currency
string | null
ExampleEUR
token
string | null
Example338e7368-4800-40ad-a4db-2e3df401087b
iban
string | null
ExampleBG31PATC4002115468108680
sortCode
string | null
Example123456
accountNumber
string | null
Example12345678
number
string | null
Example0123456789
isMain
boolean | null
Exampletrue