Payment Initiation Service Provider API
Paths
/payments/{payment-product}
This method to initiate a payment initiation at the BDSK can be sent with a JSON body depending on the payment product in the path. There are the following payment products:
- domestic-credit-transfers-bgn - Credit payment (local in BGN)
- domestic-budget-transfers-bgn - Payment to the BG budget
- sepa-credit-transfers - Payment in EUR
- cross-border-transfers
Example request body definitions:
- pisRequestBodyBGNCreditTransfer
- pisRequestBodyBGNBudgetTransfer
- pisRequestBodySEPACreditTransfer
- pisRequestBodyCrossBorderTransfer
In the test tool is used only general request body with all parameters paymentInitiationServiceRequestBody
Creates a payment initiation resource addressable under {paymentId} with all data relevant for the corresponding payment product. This is the first step in the API to initiate the related payment
Types of payment products:
- domestic-credit-transfers-bgn
- domestic-budget-transfers-bgn
- sepa-credit-transfers
- cross-border-transfers
{
"enum": [
"domestic-credit-transfers-bgn",
"domestic-budget-transfers-bgn",
"sepa-credit-transfers",
"cross-border-transfers"
]
}
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
URI of the TPP, where the transaction flow shall be redirected to after a Redirect
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
Created
{
"schema": {
"type": "object",
"required": [
"transactionStatus",
"paymentId",
"_links"
],
"properties": {
"transactionStatus": {
"$ref": "#\/definitions\/TransactionStatus"
},
"paymentId": {
"type": "string",
"description": "resource identification of the generated payment initiation resource."
},
"transactionFees": {
"$ref": "#\/definitions\/Amount",
"description": "Can be used by the BDSK to transport transaction fees relevant for the underlying payments."
},
"transactionFeeIndicator": {
"type": "boolean",
"description": "If equals “true”, the transaction will involve specific transaction cost as shown by the BDSK in their public price list or as agreed between BDSK and PSU. If equals “false”, the transaction will not
{
"schema": {
"type": "object",
"required": [
"transactionStatus",
"paymentId",
"_links"
],
"properties": {
"transactionStatus": {
"$ref": "#\/definitions\/TransactionStatus"
},
"paymentId": {
"type": "string",
"description": "resource identification of the generated payment initiation resource."
},
"transactionFees": {
"$ref": "#\/definitions\/Amount",
"description": "Can be used by the BDSK to transport transaction fees relevant for the underlying payments."
},
"transactionFeeIndicator": {
"type": "boolean",
"description": "If equals “true”, the transaction will involve specific transaction cost as shown by the BDSK in their public price list or as agreed between BDSK and PSU. If equals “false”, the transaction will not involve additional specific transaction costs to the PSU."
},
"_links": {
"$ref": "#\/definitions\/Links"
},
"psuMessage": {
"type": "string",
"description": "Text to be displayed to the PSU"
},
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
},
"tppMessages": {
"type": "array",
"items": {
"type": "string",
"description": "Messages to the TPP"
}
}
},
"example": {
"transactionStatus": "RCVD",
"paymentId": 135797531,
"_links": {
"scaRedirect": {
"href": "https:\/\/dsk\/authentication\/135797531"
},
"self": {
"href": "\/v1\/payments\/domestic-credit-transfers-bgn\/135797531"
}
}
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
},
"Location": {
"type": "string",
"description": "Location of the created resource (if created)."
},
"ASPSP-SCA-Approach": {
"type": "string",
"description": "Possible value is REDIRECT."
}
}
}
x
Bad Request
Unauthorized
Forbidden
Internal Server Error
/payments/{payment-product}/{paymentId}
Returns the content of a payment object
Types of payment products:
- domestic-credit-transfers-bgn
- domestic-budget-transfers-bgn
- sepa-credit-transfers
- cross-border-transfers
{
"enum": [
"domestic-credit-transfers-bgn",
"domestic-budget-transfers-bgn",
"sepa-credit-transfers",
"cross-border-transfers"
]
}
Resource identification of the generated payment initiation resource.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
OK
{
"schema": {
"type": "object",
"properties": {
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorName": {
"type": "string"
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"remittanceInformationUnstructured": {
"type": "string"
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode"
},
"payment-product": {
"type": "string"
},
"transactionStatus": {
"type": "string"
}
},
"example": {
"debtorAccount": {
"
{
"schema": {
"type": "object",
"properties": {
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorName": {
"type": "string"
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"remittanceInformationUnstructured": {
"type": "string"
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode"
},
"payment-product": {
"type": "string"
},
"transactionStatus": {
"type": "string"
}
},
"example": {
"debtorAccount": {
"iban": "BG009STSA000001"
},
"instructedAmount": {
"currency": "EUR",
"amount": 15
},
"creditorAccount": {
"iban": "BG009STSA000002"
},
"creditorName": "Търговец ЕООД",
"creditorAddress": {
"country": "BG"
},
"remittanceInformationUnstructured": "Ref Number Merchant",
"serviceLevel": "SEPA",
"payment-product": "sepa-credit-transfer",
"transactionStatus": "ACSP"
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
x
Bad Request
Unauthorized
Forbidden
Internal Server Error
/payments/{payment-product}/{paymentId}/status
Payment initiation status request
Reads the transaction status of the payment
Types of payment products:
- domestic-credit-transfers-bgn
- domestic-budget-transfers-bgn
- sepa-credit-transfers
- cross-border-transfers
{
"enum": [
"domestic-credit-transfers-bgn",
"domestic-budget-transfers-bgn",
"sepa-credit-transfers",
"cross-border-transfers"
]
}
Resource identification of the generated payment initiation resource.
ID of the request, unique to the call, as determined by the initiating party.
{
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
}
The forwarded IP Address header field consists of the corresponding HTTP request IP Address field between PSU and TPP.
{
"pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$"
}
The forwarded Agent header field of the http request between PSU and TPP, if available.
The forwarded IP Address header field consists of the corresponding http request IP Address field between PSU and TPP, if available.
The forwarded Geo Location header field of the corresponding http request between PSU and TPP if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
The forwarded IP Accept header fields consist of the corresponding HTTP request Accept header fields between PSU and TPP, if available.
HTTP method used at the PSU – TPP interface, if available. Valid values are:
- GET
- POST
- PUT
- PATCH
- DELETE
{
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
]
}
UUID (Universally Unique Identifier) for a device, which is used by the PSU, if available.
OK
{
"schema": {
"type": "object",
"properties": {
"transactionStatus": {
"$ref": "#\/definitions\/TransactionStatus"
}
},
"example": {
"transactionStatus": "RCVD"
}
},
"headers": {
"X-Request-ID": {
"type": "string",
"description": "ID of the request, unique to the call, as determined by the initiating party."
}
}
}
Bad Request
Unauthorized
Forbidden
Internal Server Error
Definitions
{
"type": "object",
"required": [
"currency",
"amount"
],
"properties": {
"currency": {
"type": "string",
"description": "ISO 4217 Alpha 3 currency code",
"pattern": "[A-Z]{3}",
"default": "BGN"
},
"amount": {
"type": "string",
"pattern": "^[0-9]\\d{0,13}(\\.\\d{1,2})?$",
"default": "88.55"
}
}
}
{
"type": "object",
"required": [
"country"
],
"properties": {
"street": {
"type": "string",
"maxLength": 70
},
"buildingNumber": {
"type": "string"
},
"city": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166 ALPHA2 country code",
"example": "SE",
"pattern": "[A-Z]{2}"
}
}
}
- SEPA - Used for SEPA payment
- URGP - Used for payments through RTGS System
- SDVA - Used for Cross border CT. Payment must be executed with same day value to the creditor
- NEXT - Used for Cross border CT. Payment must be executed with next working day value to the creditor
- SPOT - Used for Cross border CT. Payment must be executed with spot working day value to the creditor
{
"type": "string",
"example": "SEPA",
"enum": [
"SEPA",
"URGP",
"SDVA",
"NEXT",
"SPOT"
]
}
GOVT - Constant marked budget payment
{
"type": "string",
"enum": [
"GOVT"
]
}
- DEBT – Borne By Debtor
- CRED – Borne By Creditor
- SHAR – Shared in Credit Transfer context
- SLEV – Usefully in SEPA payments
{
"type": "string",
"example": "DEBT",
"enum": [
"DEBT",
"CRED",
"SHAR",
"SLEV"
]
}
{
"type": "object",
"required": [
"regulatoryReportType"
],
"properties": {
"regulatoryReportType": {
"description": "Regulatory Report Type – 1 digit code",
"$ref": "#\/definitions\/RegulatoryReportType"
},
"documentNumber": {
"description": "Document Number issued by Government authority. documentNumber - mandatory if value of Regulatory Report Type is 2, 3 or 6",
"type": "string"
},
"documentDate": {
"description": "Document Date issued by Government authority. documentDate mandatory if value of Regulatory Report Type is 2, 3 or 6",
"type": "string",
"format": "ISODate",
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))",
"example": "2018-03-17"
},
"taxPayerId": {
"type": "string",
"pattern": "^[0-9]{1,10}$",
"maxLength": 10
},
"taxPayerType": {
"description": "Tax Type – 3 CAP letters code",
"$ref": "#\/definitions\/TaxTypeCode"
},
"paymentCategory": {
"description": "Payment Category – 6 digit code. Mandatory if IBAN of creditorAccount contains \"8\" in position 13.",
"$ref": "#\/definitions\/PaymentCategoryCode"
},
"fromDate": {
"description": "From Date – start of period date. fromDate mandatory if value of Regulatory Report Type is 1, 2, 4 or 5",
"type": "string",
"format": "ISODate",
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))",
"example": "2019-02-10"
},
"endDate": {
"description": "End Date – end of period date. endDate mandatory if value of Regulatory Report Type is 1, 2, 4 or 5",
"type": "string",
"format": "ISODate",
"pattern": "([12]\\d{3}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01]))",
"example": "2019-08-10"
}
}
}
- 1 – Declaration
- 2 – Inspection ACt
- 3 – Penalty Decree
- 4 – advance payment
- 5 – batch property number
- 6 – enforces collection order
- 9 – others
{
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"5",
"6",
"9"
]
}
- EGN – Personal ID
- EIK – Corporate ID
- PNF – Foreign Person ID
{
"type": "string",
"enum": [
"EGN",
"EIK",
"PNF"
],
"maxLength": 3
}
- 110000 - НАП (NRA)
- 551111 - НОИ (NSSI)
- 561111 - НЗОК (NHIF)
- 581111 - ДЗПО (SCPI)
{
"type": "string",
"enum": [
"110000",
"551111",
"561111",
"581111"
],
"maxLength": 6
}
{
"type": "object",
"properties": {
"scaRedirect": {
"$ref": "#\/definitions\/Href",
"description": "A link to a BDSK site where SCA is performed within the Redirect SCA approach."
},
"self": {
"$ref": "#\/definitions\/Href",
"description": "The link to the payment initiation resource created by the request itself. This link can be used later to retrieve the transaction status of the payment initiation."
},
"status": {
"$ref": "#\/definitions\/Href",
"description": "The link to retrieve the transaction status of the payment initiation."
}
}
}
The transaction status is filled with codes of the ISO 20022 data table.
{
"type": "string",
"enum": [
"ACSC",
"ACSP",
"ACTC",
"RCVD",
"RJCT"
]
}
{
"type": "object",
"properties": {
"tppMessages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"type": "string"
},
"code": {
"type": "string"
},
"text": {
"type": "string"
}
}
}
}
}
}
{
"type": "object",
"required": [
"instructedAmount",
"debtorAccount",
"creditorName",
"creditorAccount"
],
"properties": {
"endToEndIdentification": {
"type": "string",
"maxLength": 35
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"ultimateDebtor": {
"type": "string",
"maxLength": 70,
"description": "Mandatory for: domestic-budget-transfers-bgn. N.A. for: domestic-credit-transfers-bgn, sepa-credit-transfers, cross-border-transfers."
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorAgent": {
"type": "string",
"default": "AAAADEBBXXX",
"pattern": "[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}"
},
"creditorAgentName": {
"type": "string",
"description": "Mandatory for creditorAccount when payment is cross-border-transfers - If no IBAN used for creditorAccount. N.A. for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn, sepa-credit-transfers.",
"maxLength": 70
},
"creditorAgentAddress": {
"description": "Mandatory for creditorAccount when payment is cross-border-transfers - If no IBAN used for creditorAccount. N.A. for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn, sepa-credit-transfers.",
"$ref": "#\/definitions\/Address"
},
"creditorName": {
"type": "string",
"description": "Creditor Name",
"default": "Търговец ЕООД",
"maxLength": 70
},
"creditorAddress": {
"description": "Mandatory for: cross-border-transfers. Optional for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn, sepa-credit-transfers. ",
"$ref": "#\/definitions\/Address"
},
"purposeCode": {
"description": "Mandatory for: domestic-budget-transfers-bgn. N.A. for: domestic-credit-transfers-bgn, cross-border-transfers, sepa-credit-transfers.",
"$ref": "#\/definitions\/PurposeCode"
},
"chargeBearer": {
"description": "Mandatory for: cross-border-transfers. Optional for: sepa-credit-transfers. N.A. for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn.",
"$ref": "#\/definitions\/ChargeBearerCode"
},
"remittanceInformationUnstructured": {
"type": "string",
"description": "Mandatory for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn. Optional for: sepa-credit-transfers, cross-border-transfers.",
"default": "Ref Number Merchant",
"maxLength": 140
},
"serviceLevel": {
"description": "Mandatory for: sepa-credit-transfers, cross-border-transfers. Optional for: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn.",
"$ref": "#\/definitions\/ServiceLevelCode"
},
"budgetPaymentDetails": {
"description": "Mandatory for: domestic-budget-transfers-bgn. N.A. for: domestic-credit-transfers-bgn, sepa-credit-transfers, cross-border-transfers.",
"$ref": "#\/definitions\/BudgetPaymentDetails"
}
}
}
{
"type": "object",
"required": [
"instructedAmount",
"debtorAccount",
"creditorName",
"creditorAccount",
"serviceLevel"
],
"properties": {
"endToEndIdentification": {
"type": "string",
"maxLength": 35
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorAgent": {
"type": "string",
"default": "AAAADEBBXXX",
"pattern": "[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}"
},
"creditorName": {
"type": "string",
"description": "Creditor Name",
"default": "Търговец ЕООД",
"maxLength": 70
},
"chargeBearer": {
"$ref": "#\/definitions\/ChargeBearerCode"
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"remittanceInformationUnstructured": {
"type": "string",
"default": "Ref Number Merchant",
"maxLength": 140
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode"
}
}
}
{
"type": "object",
"required": [
"instructedAmount",
"debtorAccount",
"ultimateDebtor",
"creditorName",
"creditorAccount",
"purposeCode",
"remittanceInformationUnstructured",
"budgetPaymentDetails"
],
"properties": {
"endToEndIdentification": {
"type": "string",
"maxLength": 35
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"ultimateDebtor": {
"type": "string",
"maxLength": 70
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorAgent": {
"type": "string",
"default": "AAAADEBBXXX",
"pattern": "[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}"
},
"creditorName": {
"type": "string",
"description": "Creditor Name",
"default": "Търговец ЕООД",
"maxLength": 70
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"purposeCode": {
"$ref": "#\/definitions\/PurposeCode"
},
"remittanceInformationUnstructured": {
"type": "string",
"default": "Ref Number Merchant",
"maxLength": 140
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode"
},
"budgetPaymentDetails": {
"$ref": "#\/definitions\/BudgetPaymentDetails"
}
}
}
{
"type": "object",
"required": [
"instructedAmount",
"debtorAccount",
"creditorName",
"creditorAccount",
"remittanceInformationUnstructured"
],
"properties": {
"endToEndIdentification": {
"type": "string",
"maxLength": 35
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorAgent": {
"type": "string",
"default": "AAAADEBBXXX",
"pattern": "[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}"
},
"creditorName": {
"type": "string",
"description": "Creditor Name",
"default": "Търговец ЕООД",
"maxLength": 70
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"remittanceInformationUnstructured": {
"type": "string",
"default": "Ref Number Merchant",
"maxLength": 140
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode"
}
}
}
{
"type": "object",
"required": [
"instructedAmount",
"debtorAccount",
"creditorName",
"creditorAccount",
"creditorAddress",
"serviceLevel",
"chargeBearer"
],
"properties": {
"endToEndIdentification": {
"type": "string",
"maxLength": 35
},
"debtorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"instructedAmount": {
"$ref": "#\/definitions\/Amount"
},
"creditorAccount": {
"$ref": "#\/definitions\/AccountReference"
},
"creditorAgent": {
"type": "string",
"default": "AAAADEBBXXX",
"pattern": "[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}"
},
"creditorAgentName": {
"type": "string",
"description": "Mandatory, if no IBAN used for creditorAccount.",
"maxLength": 70
},
"creditorAgentAddress": {
"description": "Mandatory, if no IBAN used for creditorAccount.",
"$ref": "#\/definitions\/Address"
},
"creditorName": {
"type": "string",
"description": "Creditor Name",
"default": "Търговец ЕООД",
"maxLength": 70
},
"creditorAddress": {
"$ref": "#\/definitions\/Address"
},
"chargeBearer": {
"$ref": "#\/definitions\/ChargeBearerCode"
},
"remittanceInformationUnstructured": {
"type": "string",
"default": "Ref Number Merchant",
"maxLength": 140
},
"serviceLevel": {
"$ref": "#\/definitions\/ServiceLevelCode",
"example": "SPOT"
}
}
}
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"description": "IBAN of account, mandatory for debtorAccount for all payments and mandatory for creditorAccount when payment is: domestic-credit-transfers-bgn, domestic-budget-transfers-bgn, sepa-credit-transfers. Optional for creditorAccount when payment is cross-border-transfers. If no IBAN used then \"creditorAgentName\" and \"creditorAgentAddress\" have to be filled. For domestic-budget-transfers-bgn payment initiation, position 13 of creditorAccount IBAN must contain \"8\" or \"3\" only.",
"pattern": "[A-Z]{2,2}[0-9]{2,2}[a-zA-Z0-9]{1,30}",
"default": "BG009STSA000001"
}
}
}
{
"type": "string",
"properties": {
"href": {
"type": "string"
}
}
}