Skip to content
Developer Docs

Configuration Details

GET
/flow-customization/v1/configurations/{configurationUuid}

Returns the specific configuration applied to a flow or operation. Defines how the payment page is presented and behaves.

Includes the appearance, operation behaviour and payer redirection settings. The configurationUuid is the identifier shown in the Dashboard detail view and is the value you reference in every API call that consumes a configuration.

Authorizations

OAuth2

OAuth2 security scheme

clientCredentials Flow
Token URL"/api/v2/auth/token"
Scopes:
  • "zertiban-api"Access to the API

Parameters

Header Parameters

x-tenant-id*

Business UUID to filter the request

Type
string
Required

Path Parameters

configurationUuid*

Identifies the configuration that will be retrieved

Type
string
Required
Format
"uuid"

Query Parameters

operation_type

The operation type

Type
string
Valid values
"SIGNATURE""SEPA""SIGNATURE_SEPA""PAYMENT"
Example"SIGNATURE"

Responses

Customization successfully retrieved

application/json
JSON
{
  
"uuid": "string",
  
"name": "string",
  
"description": "string",
  
"createdAt": "2025-01-01T00:00:01Z",
  
"isDefault": true,
  
"status": "ACTIVE",
  
"visualConfiguration": {
  
  
"icon": "string",
  
  
"logo": "string",
  
  
"brandColor": "string",
  
  
"accentColor": "string",
  
  
"language": "string",
  
  
"downloadSignedDocumentsButton": true,
  
  
"autoDownloadDocuments": true
  
},
  
"operationConfiguration": {
  
  
"documentDelivery": {
  
  
  
"includePaymentReceiptInDownload": true,
  
  
  
"sendDocumentsByEmail": true,
  
  
  
"carbonCopyRecipients": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"blindCarbonCopyRecipients": [
  
  
  
  
"string"
  
  
  
]
  
  
},
  
  
"redirection": {
  
  
  
"callback": {
  
  
  
  
"url": "string",
  
  
  
  
"requestTimeout": 0,
  
  
  
  
"parameters": [
  
  
  
  
  
"string"
  
  
  
  
]
  
  
  
},
  
  
  
"return": {
  
  
  
  
"url": "string",
  
  
  
  
"parameters": [
  
  
  
  
  
"string"
  
  
  
  
]
  
  
  
}
  
  
}
  
},
  
"signatureConfiguration": {
  
  
"SIGNATURE": {
  
  
  
"signingMethods": [
  
  
  
  
"string"
  
  
  
],
  
  
  
"failoverCertificateSignature": true,
  
  
  
"failoverSmsSignature": true
  
  
}
  
}
}

Playground

Authorization
Headers
Variables
Key
Value

Samples