Bulk payments

Below you find example values for all our APIs. The example certificate is used for the signing in the Signature Certificate header.

Example metadata

Example of metadata (including SampleFile):

Premium - Business Bulk Payment Initiation

--WebKitFormBoundaryOEFsgWLJCyxInJHO\r\n
Content-Disposition: form-data; name="xml_sct"; filename="SampleFile.xml"\r\n
Content-Type: application/xml\r\n
\r\n
<-content of SampleFile.xml->\r\n
--WebKitFormBoundaryOEFsgWLJCyxInJHO--\r\n

--WebKitFormBoundaryOEFsgWLJCyxInJHO\r\n
Content-Disposition: form-data; name="xml_sct"; filename="SampleFile.xml.gz"\r\n
Content-Type: application/gzip\r\n
\r\n
<-content of SampleFile.xml.gz->\r\n
--WebKitFormBoundaryOEFsgWLJCyxInJHO--\r\n

Premium - Business Direct Debit

--WebKitFormBoundaryOEFsgWLJCyxInJHO\r\n
Content-Disposition: form-data; name="xml_dd"; filename="SampleFile.xml"\r\n
Content-Type: application/xml\r\n
\r\n
<-content of SampleFile.xml->\r\n
--WebKitFormBoundaryOEFsgWLJCyxInJHO--\r\n

--WebKitFormBoundaryOEFsgWLJCyxInJHO\r\n
Content-Disposition: form-data; name="xml_dd"; filename="SampleFile.xml.gz"\r\n
Content-Type: application/gzip\r\n
\r\n
<-content of SampleFile.xml.gz->\r\n
--WebKitFormBoundaryOEFsgWLJCyxInJHO--\r\n

📘
\r\n represent the special characters for Carriage Return, Line feed.

Download and use the sample XML file below to reproduce the example values in this document.

🚧
In the example values on this page a static boundary is used

PSD2

Bulk XML – ⤓ SampleFile.xml
Bulk Gzip – ⤓ SampleFile.xml.gz

Premium

BBPI XML - ⤓ SampleFile.xml
BBPI Gzip – ⤓ SampleFile.xml.gz

BDD XML - ⤓ SampleFile.xml
BDD Gzip – ⤓ SampleFile.xml.gz

🚧
Due to security regulation, spaces or line breaks between JSON elements cause an incorrect digest error.

Digest header

Examples of the digest header for various APIs and their bodies using SHA-512:

Premium - Business Bulk Payment Initiation

digest: sha-512=j36brqM2uQlpXw7CvhiTiefid4MV9hWTJ8iD9L8XF3CoOG6pp5dhZOAybZOdXvildAfX0yzvlcTzeJc/MK3Xhg==

digest: sha-512=UZdSfPJWoemh4a66pcDo62xoDWAp0RPAZf5qRaEUBtA7FZvHI+dKTkZPhw0r9oiMRHpGkviHrmRxN0RpUW2QRg==

Premium - Business Direct Debit

digest: sha-512=06EL+s99pvPWCCPY1KsCdqSpOHrPbjWh5mDC3zk2I+F4v20cPlY+04rgkWB5waE11tZv1uYVGFnCagJEgwqyuA==

digest: sha-512=3cTzhyFZAFpIpVdibHkiOlKyxWOaDH0/ZP9afV2UN1YI1HVPnW19y+Hd4nGrRjutHhv+F08yJIBkHmds5zYUyg==

Signing string

Examples of the signing string for various APIs:

Premium - Business Bulk Payment Initiation

date: Fri, 30 Jul 2021 10:30:00 GMT
digest: sha-512=j36brqM2uQlpXw7CvhiTiefid4MV9hWTJ8iD9L8XF3CoOG6pp5dhZOAybZOdXvildAfX0yzvlcTzeJc/MK3Xhg==
x-request-id: d65d4172-03fe-41f7-afd5-6f4ae50f73c4

date: Fri, 30 Jul 2021 10:30:00 GMT
digest: sha-512=UZdSfPJWoemh4a66pcDo62xoDWAp0RPAZf5qRaEUBtA7FZvHI+dKTkZPhw0r9oiMRHpGkviHrmRxN0RpUW2QRg==
x-request-id: d65d4172-03fe-41f7-afd5-6f4ae50f73c4

Premium - Business Direct Debit

date: Fri, 30 Jul 2021 10:30:00 GMT
digest: sha-512=06EL+s99pvPWCCPY1KsCdqSpOHrPbjWh5mDC3zk2I+F4v20cPlY+04rgkWB5waE11tZv1uYVGFnCagJEgwqyuA==
x-request-id: d65d4172-03fe-41f7-afd5-6f4ae50f73c4

date: Fri, 30 Jul 2021 10:30:00 GMT
digest: sha-512=3cTzhyFZAFpIpVdibHkiOlKyxWOaDH0/ZP9afV2UN1YI1HVPnW19y+Hd4nGrRjutHhv+F08yJIBkHmds5zYUyg===
x-request-id: d65d4172-03fe-41f7-afd5-6f4ae50f73c4

Signature

Examples of the signature for various APIs:

Premium - Business Bulk Payment Initiation

NDNE0WFictyXYHSeBOGhDZl0MKfmUhoozi2DdwgjwfeBLh7VdV8uip2ydf52ZHXXcdojHSeCQ77EL1MW8xr9LeKE0ESFvoX1VVNb07MUaMa9+H4X0epV9oeDCO2pyLUGj1JMs0G1uwGnxGBpFwBZdeX903IbgquTk99Yo7BzK54yxwWsLVQ7FMrXTNwL2jOv3b5LdQemLuqfBnXPYF8OkAXzaGl37LyGJz5rewCQICJrngaiDb8fHOGzMTf7JdG94AtJTk8BeRb0lzRlEBKbIJhPCLi9Va1KGHWRPMSdcfDRpaxgdEK2rWl9AMqkjY/d3Nx8pI+IRDD4SLIAVNLCKQ==

gnsrewNsAXG23FH/aAprEag3elJm8aXPPJ03cfuC2I6yX0DIjvkCyI1eegwKAbjYFg6QHo8WQTacahK6rmHZ5OfBOXenU+82MlmuqoZnlkTearWmhmP8jfSh99Ony1mTe4jpxjSVouwOqioQoVYAQIu1Wiy/sdqfJ7GA5AiwuQ0u3Zb6LZQvEdw549cYr4R8jwiiIPeo9kUQ3xKPVDOLfQ0pavl8QbDe8JnS3x4Llv+UKlKhkb9ufCRd6hhQYJvf+Nm6qk3rXagd/nw1nCKhaSIlOw32yz1hz3Ln5UnYJRqOtfKS9yx5f1ITh4uoCY7HExAfFDqnCKSLFZ5DC6gnqw==

Premium - Business Direct Debit

R/8ZLvdDS3SVHVi1gV9x77uGphoFi4MuN9PC/SXIqPYltdVLxLC5bN68jfAPpB+2RSYbv6FNZ53P/sOEssbQX6VMBhATxX/jb87lCjOab/R9UHe7oa0x40/wf7bnTxfv45TwCMpPVdB08TvgVI1xWS/UjMRHMie85zrRwKzzGoalhOnGTf4NTilOuZsW8244QH9D5uhIG5z0Ojj+Ix7+J12aUGPGMyShAmMFWAvZdLtSOf0SQ8YlK7lw4uvjdgty2vllXOK84qVIEffj27s16CectDcdcP5OJvD88PDE6gtd0gKUCepIjJ7h4MOzS4ch9dhmyOYTSVIxumrqE+GYsw==

KjHYW5TTehLXHFYKZpeHuclUs2QUQJKo/3G/2wRj8JhvwGkhVRkvF6/ZHytNRZTtt8ohnCyoNS+DNgyiZS3wcMQGH589Jqv0vj76nEyWsucgXnXmzXWfZpLrNPVR7vi8cTwvbq39NWz3heeUy5M0ddN4FkV7erm+svEURuxVQLxo/iq8RxCQ3LCYsTko/9AIe4aGk1tkoZN+zMfkTPJoRrV9R/fYfnNht60+P1KsHYIEFoGwa0Ibp7fu+H19cGtFqtw0q9ISz9cafP0JzbDYbResVeMZeON2BV/U7Q2HDGJkUuMVyztVoM0eRF0ba8MRtDwQk/z6M3vWKnAZs455GQ==

Signature header

The resulting signature header for our example:

Premium - Business Bulk Payment Initiation

signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="NDNE0WFictyXYHSeBOGhDZl0MKfmUhoozi2DdwgjwfeBLh7VdV8uip2ydf52ZHXXcdojHSeCQ77EL1MW8xr9LeKE0ESFvoX1VVNb07MUaMa9+H4X0epV9oeDCO2pyLUGj1JMs0G1uwGnxGBpFwBZdeX903IbgquTk99Yo7BzK54yxwWsLVQ7FMrXTNwL2jOv3b5LdQemLuqfBnXPYF8OkAXzaGl37LyGJz5rewCQICJrngaiDb8fHOGzMTf7JdG94AtJTk8BeRb0lzRlEBKbIJhPCLi9Va1KGHWRPMSdcfDRpaxgdEK2rWl9AMqkjY/d3Nx8pI+IRDD4SLIAVNLCKQ=="

signature: keyId="1523433508",algorithm="rsa-sha512",headers="date digest x-request-id",signature="gnsrewNsAXG23FH/aAprEag3elJm8aXPPJ03cfuC2I6yX0DIjvkCyI1eegwKAbjYFg6QHo8WQTacahK6rmHZ5OfBOXenU+82MlmuqoZnlkTearWmhmP8jfSh99Ony1mTe4jpxjSVouwOqioQoVYAQIu1Wiy/sdqfJ7GA5AiwuQ0u3Zb6LZQvEdw549cYr4R8jwiiIPeo9kUQ3xKPVDOLfQ0pavl8QbDe8JnS3x4Llv+UKlKhkb9ufCRd6hhQYJvf+Nm6qk3rXagd/nw1nCKhaSIlOw32yz1hz3Ln5UnYJRqOtfKS9yx5f1ITh4uoCY7HExAfFDqnCKSLFZ5DC6gnqw=="

Premium - Business Direct Debit

signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="R/8ZLvdDS3SVHVi1gV9x77uGphoFi4MuN9PC/SXIqPYltdVLxLC5bN68jfAPpB+2RSYbv6FNZ53P/sOEssbQX6VMBhATxX/jb87lCjOab/R9UHe7oa0x40/wf7bnTxfv45TwCMpPVdB08TvgVI1xWS/UjMRHMie85zrRwKzzGoalhOnGTf4NTilOuZsW8244QH9D5uhIG5z0Ojj+Ix7+J12aUGPGMyShAmMFWAvZdLtSOf0SQ8YlK7lw4uvjdgty2vllXOK84qVIEffj27s16CectDcdcP5OJvD88PDE6gtd0gKUCepIjJ7h4MOzS4ch9dhmyOYTSVIxumrqE+GYsw=="

signature: keyId="1523433508",algorithm="rsa-sha512",headers="date digest x-request-id",signature="KjHYW5TTehLXHFYKZpeHuclUs2QUQJKo/3G/2wRj8JhvwGkhVRkvF6/ZHytNRZTtt8ohnCyoNS+DNgyiZS3wcMQGH589Jqv0vj76nEyWsucgXnXmzXWfZpLrNPVR7vi8cTwvbq39NWz3heeUy5M0ddN4FkV7erm+svEURuxVQLxo/iq8RxCQ3LCYsTko/9AIe4aGk1tkoZN+zMfkTPJoRrV9R/fYfnNht60+P1KsHYIEFoGwa0Ibp7fu+H19cGtFqtw0q9ISz9cafP0JzbDYbResVeMZeON2BV/U7Q2HDGJkUuMVyztVoM0eRF0ba8MRtDwQk/z6M3vWKnAZs455GQ=="

Header containing the certificate

The result with our example certificate would be:

Premium

Signature-Certificate: MIID9DCCAtygAwIBAgIUUzEdjjbjLOePU7NeZfai6bv9RJIwDQYJKoZIhvcNAQELBQAweDEyMDAGA1UEAwwpUmFib2JhbmsgZGV2ZWxvcGVyIHBvcnRhbCBTYW5kYm94IHRlc3RpbmcxCzAJBgNVBAYTAk5MMRAwDgYDVQQIDAdVdHJlY2h0MRAwDgYDVQQHDAdVdHJlY2h0MREwDwYDVQQKDAhSYWJvYmFuazAgFw0yNTExMTIxNTQ3MzRaGA8yMTAwMTAyNTE1NDczNFoweDEyMDAGA1UEAwwpUmFib2JhbmsgZGV2ZWxvcGVyIHBvcnRhbCBTYW5kYm94IHRlc3RpbmcxCzAJBgNVBAYTAk5MMRAwDgYDVQQIDAdVdHJlY2h0MRAwDgYDVQQHDAdVdHJlY2h0MREwDwYDVQQKDAhSYWJvYmFuazCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALGoQqBxfADuEAHs/k1UoKkqn1XrK3ocV/rItsnCU3ynW9gahC8Ggj4UtcjNcXh8fBieV+6oeFcMRXofY6PiS6IM3YxofwMUM0JqTC/JZcoVhnEButAbg+DVJJfR7jxEDFUR2LL2RTLHYugtJdbg92kuUy7bXjayj6/Ef2R3s+cI7rHiI7oAftce61k4sVmQxGtxAVt+jrSB8eX/hVqdzfNb1MSzRbfII56rLgeaSbWm7gkYcJimyWjPuabqxY0cIvwkum5BRJ87x+QRdxzJuXYuwZsUMaY4ETYiiwUv7Q2vOZ066a6zBs++JSdgCUypvqm9YvRn3vCxB3+me+jvhdUCAwEAAaN0MHIwHQYDVR0OBBYEFHr3mI71/GxAJ/nDhNTZL+XEX6cZMB8GA1UdIwQYMBaAFHr3mI71/GxAJ/nDhNTZL+XEX6cZMA4GA1UdDwEB/wQEAwIFoDAgBgNVHSUBAf8EFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwDQYJKoZIhvcNAQELBQADggEBAEZod53U0IhIQZSVo4mVSn/bWT53uaeAcSwtRi+hyb8K2nDmT8wWdb6xewghd6EXIpWwetG8+odqvCaatdwPa4XjxE9XEecZC+EAYucY7joEk+maDjgJdgNNCwmWGQvOi9Fav9o2bbSGC3Y615K34aMmSNfuCGJHTw88RciLhPUdLMQF3gUTcQjlRcmE0oBZilZ0BF8Q1BIaJiFZZ7nNb4FGYB3ouySsmz/aPTz+VENZp2geCGjxW+SUIVpKiWA6NN2iJkp4Zywe39FxCca0Fw+QHl0vuMhh5fxyFA3eJLZREsZdgqwXnvIwNIM6/Yd1lxUIEyHL1J/m/vcJv/X0ZY4=