Single
A guide for developers to try code examples and test Rabobank’s Business Payment Initiation APIs.
The Rabobank Sandbox uses stubs.
- End‑to‑end flows cannot be tested—only simulated responses.
- Certificates are not validated against requirements.
Authentication in Sandbox
We provide a key and certificate for mTLS authentication and request signing:
mTLS
Signing
Base URL
All sandbox API endpoints start with:
https://api-sandbox.rabobank.nl/openapi/sandbox/payments
Available Endpoints
Payment Initiation
- Payment Initiation:
POST /v1/single/sepa-credit-transfers - Periodic payment initiation:
POST /v1/periodic/sepa-credit-transfers - Cross border payment initation:
POST /v1/single/cross-border-credit-transfers - Periodic cross border payment initiation:
POST /v1/periodic/cross-border-credit-transfers
Payment Status
- Status retrieval single payment:
GET /v1/single/sepa-credit-transfers/{paymentId}/status - Status retrieval periodic payment:
GET /v1/periodic/sepa-credit-transfers/{paymentId}/status - Status retrieval cross border payment:
GET /v1/single/cross-border-credit-transfers/{paymentId}/status - Status retrieval periodic cross border payment:
GET /v1/periodic/cross-border-credit-transfers/{paymentId}/status
Payment Details
- Details single payment:
GET /v1/single/sepa-credit-transfers/{paymentId} - Details periodic payment:
GET /v1/periodic/sepa-credit-transfers/{paymentId} - Details cross border payment:
GET /v1/single/cross-border-credit-transfers/{paymentId} - Details periodic cross border payment:
GET /v1/periodic/cross-border-credit-transfers/{paymentId}
Example requests and responses
Initiate a single payment
Endpoint: https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/sepa-credit-transfers
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
PSU-IP-Address: 192.68.1.1
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=
Date: Tue, 24 Jan 2023 06:53:05 GMT
IP-Redirect-URI: <string>
IP-Nok-Redirect-URI: <string>
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="AO2rZUw5MKHNpvM/r2zdQqy2lKB0Mio3C+uX/oFZYmKJKL7q15cOQkk+xWn157YvgsImaEGiPOoEbffRH951wKH0LJBghOjsUIjqq7Be41V+UFQeZ8Oj60EaPnN1I0Kw9OU21emmxvtZbNp9UAdh7KoGQJA9Kzic9c4Fwp3m3oj1/rGcK0FCycit1pr4z7dFgHNZNq0saUVUOIMzrYs/w1bs2xYIqJY/d0lEu/LRABWrQboQO1KjgboTt900w4F4LtAPqZuKhd59g/j2kP6gEOJayDoaJ+NoeGMFWc4HXHOtuXeAKJuVNNv2O7q1O4tWu1j4qRlqG2kiBpKd89S3Gg=="
Digest: sha-512=zHM9txFwU718P3n7PxunDWpzrpPNaa6Rb9JKoU5JIkLuLliiiobFYHYDEDoi7wO6Nj0Z00uqWtOcjjSDQzpxmw==
redirectionFlag: No
Content-Type: application/json
Accept: application/json
Body: {"creditorAccount":{"iban":"NL10RABO0123456789","currency":"EUR"},"creditorName":"Company","debtorAccount":{"currency":"EUR","iban":"NL10RABO0912345678"},"instructedAmount":{"content":"10.25","currency":"EUR"},"creditorAddress":{"country":"NL","buildingNumber":"8","postcode":"2456RL","streetName":"Utrechtstraat","townName":"Utrecht"},"creditorAgent":"RABONL2U","debtorName":"Allen Martin","endToEndIdentification":"PI-123456789","remittanceInformationStructured":{"reference":"1515140706132013","referenceIssuer":"CUR","referenceType":"SCOR"},"requestedExecutionDate":"2023-01-25"}Response
{
"paymentId": "123e4567-e89b-42d3-a456-556642440005",
"transactionStatus": "PDNG"
}Endpoint: https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/sepa-credit-transfers
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
PSU-IP-Address: 192.68.1.1
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=
Date: Tue, 24 Jan 2023 06:53:05 GMT
IP-Redirect-URI: <string>
IP-Nok-Redirect-URI: <string>
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="QdF+yom2+NgJ0YLyFOP3beZuhM7lpIdljndphOej85FnxO1om6Q6rSFJvZuePWUavj4Sl8JZMeHnWXPnlOxItKTldwe61hJ81qjGUiMz3SIHQeOfBzK87LoVI/5HdiJ35E4+pAjtNUf9MnahUMcKKGEuzGAW0nfs+GBUPxJshPJqGq0Wkelih6XvUAhrd0DTb7UETtvPFaHhHxCI9rDlfT1W//2ZqOlO+238K3wLpZDgGbG0GV4++SiA2OhEGuHJRr/KY+2P5yoZJPXRBFUZfdw0FPdPRCoOXyNwq4A/bzgFmP99R2U4ZYkg9uubeF5w0m/iI+Xb518G9YKoqcbotQ=="
Digest: sha-512=HJcQr3G5Zt2izNQcFmfqBLONnSqb4pVQ4vaC7bAoAvS9Q9/5vyVqfm998CkKx+9v9QxTOmKLDbxvhxUhk/DZmw==
redirectionFlag: No
Content-Type: application/json
Accept: application/json
Body: {"creditorAccount":{"iban":"NL10RABO0123456789","currency":"EUR"},"creditorName":"Company","debtorAccount":{"currency":"EUR","iban":"NL10RABO0912345678"},"frequency":"Quarterly","instructedAmount":{"content":"10.25","currency":"EUR"},"startDate":"2023-01-25","creditorAddress":{"country":"NL","buildingNumber":"8","postcode":"2456RL","streetName":"Utrechtstraat","townName":"Utrecht"},"creditorAgent":"RABONL2U","debtorName":"Allen Martin","endToEndIdentification":"PI-123456789","requestedExecutionDate":"2023-01-25","remittanceInformationStructured":{"reference":"1515140706132013","referenceIssuer":"CUR","referenceType":"SCOR"},"endDate":"2024-05-24"}Response
{
"paymentId": "123e4567-e89b-42d3-a456-556642440005",
"transactionStatus": "PDNG"
}Endpoint: https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/cross-border-credit-transfers
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
PSU-IP-Address: 192.68.1.1
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=
Date: Tue, 24 Jan 2023 06:53:05 GMT
IP-Redirect-URI: <string>
IP-Nok-Redirect-URI: <string>
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="img7Sh3LXEGore0zRoFk0g2l9b2YdAZDuOlDNCo50J6SB3o6baDQW8h5aS4mmEZiXLI6Hel0M/RIBGTq3WV/ACxffqrWgu7Ep91LdJ4XybvWDXiXjRT4x3zshfHLu7X/vlqv0GqA9IFHZtwimw+511h1beNhUeQJXRatjXw0XUvzaNeidgCrtLhOBeny53kloVjKM3H/hppkDqEE4dsmqZ/nVtU/w2eLwNeAdeQ6/8KB6o/aDf7wdnIvwF918M7FJ985/7R+/LyE8UqotTR7Pq0ofueEErBvv+6KgEfN3sTEsSNUDjIqwUBMD1qEGaPF2uimrQQB9iithhOV4DOucQ=="
Digest: sha-512=8szvAigpAj1WJbILK9EgRF/+nYDEO9CpLo7sKkcjlsHEQk7fgYnQ45gR1SjDmhk8mwLdtODagjm0ygAA/WCxIw==
redirectionFlag: No
Content-Type: application/json
Accept: application/json
Body: {"chargeBearer":"DEBT","creditorAccount":{"currency":"USD","bban":"02100002112345678901234567"},"creditorAddress":{"country":"US","buildingNumber":"8C","postcode":"5017","streetName":"5th Ave","townName":"New York"},"creditorAgent":"BANKUS33XXX","creditorName":"Company","debtorAccount":{"currency":"EUR","iban":"NL10RABO0912345678"},"instructedAmount":{"content":"10.25","currency":"USD"},"debtorName":"Allen Martin","endToEndIdentification":"PI-123456789","remittanceInformationStructured":{"reference":"1515140706132013","referenceIssuer":"CUR","referenceType":"SCOR"},"requestedExecutionDate":"2023-01-25"}Response
{
"paymentId": "123e4567-e89b-42d3-a456-556642440005",
"transactionStatus": "PDNG"
}Endpoint: https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/cross-border-credit-transfers
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
PSU-IP-Address: 192.68.1.1
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=
Date: Tue, 24 Jan 2023 06:53:05 GMT
IP-Redirect-URI: <string>
IP-Nok-Redirect-URI: <string>
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="H9weEwrWd2yxm+eRywUX9UZXBOrmM3af8S9SGm/765PhJuvV7eEfy6vDhn8Be6aB9cxuoGOESv6yud5qBhK7nfQVYsJC8+TSgb/KNm5G0mEKMTEq/SWdUPN+UjDLRGb1JHkzftd1WUrs5dCTBjoNUbpIkERIjidxyF/RqESOibRWwQJFNcBMThW/QtyWp3W8ju2S6MfvAyESuOQhBrAp9v03teRFS0ffgHpdu0OZx2TkoO7B+QHj0NjSId7Qh03UcgNx0hKD5uU68ilQFVIBolJPDtqHdufjI6QKY5aZ2sZ9JJ9iyjUbgRMFB/iwgaGbLtl3H1FH6+++qBR9ZxTo+w=="
Digest: sha-512=HSV/LRwpyaCZ5KwBRpN5ie4rQHigAJwqTOafADRuZ2ZltDrv0umuYmGYz38x5OAwKmAQgRctLJ68jNfIKHnQnQ==
redirectionFlag: No
Content-Type: application/json
Accept: application/json
Body: {"chargeBearer":"CRED","creditorAccount":{"currency":"GBP","iban":"GB60BARC48291709876543"},"creditorAddress":{"country":"UK","buildingNumber":"54","postcode":"N1 1PX","streetName":"Islington Park St","townName":"London"},"creditorAgent":"BARCGB21","creditorName":"Company","debtorAccount":{"currency":"EUR","iban":"NL10RABO0912345678"},"frequency":"Quarterly","instructedAmount":{"content":"10.25","currency":"GBP"},"startDate":"2023-01-25","debtorName":"Allen Martin","endToEndIdentification":"PI-123456789","remittanceInformationStructured":{"reference":"1515140706132013","referenceIssuer":"CUR","referenceType":"SCOR"},"requestedExecutionDate":"2023-01-25","endDate":"2024-05-24"}Response
{
"paymentId": "123e4567-e89b-42d3-a456-556642440005",
"transactionStatus": "PDNG"
}Retrieve status
Endpoints:
https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/sepa-credit-transfers/123e4567-e89b-42d3-a456-556642440005/statushttps://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/sepa-credit-transfers/123e4567-e89b-42d3-a456-556642440005/statushttps://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/cross-border-credit-transfers/123e4567-e89b-42d3-a456-556642440005/statushttps://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/cross-border-credit-transfers/123e4567-e89b-42d3-a456-556642440005/status
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
Date: Tue, 24 Jan 2023 06:53:05 GMT
Digest: sha-512=z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg==
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="k0EwYuRkiHvDt2zx2g9GHz8AzxyVhRuAlAhY0SvHiNrm2tOCpNhwVKoyHHrCa9+CHdLikxGE+r4sTIvD4LwIGhfWGPXUZWCIqczFRVNVZrr4EEmxTzu9tp62BeLdYRqvpIB7K/JGiAzFukqhuYkneQp1cVsT5KWWvoVVHXUcPKTadG0OTBwzfnxGwARum6TWvU9x/TTxcangt+64qrmNAhv7w/EipyzALKN9BNcEzpDxfrAWKeFkjYuReC+ke0RPlxn8T0IM2SVIjehejOS9hgizxi5YhZoB8D6X3qKzktMnCCyhhhXHKowBMmry91wJ4GqtT/yXoHXBnFr6mjkjBw=="
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=
PSU-IP-Address: 192.68.1.1
Accept: application/json
Body: Response
{
"transactionStatus": "ACSC"
}Retrieve payment details
Endpoints:
-
https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/sepa-credit-transfers/123e4567-e89b-42d3-a456-556642440005 -
https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/sepa-credit-transfers/123e4567-e89b-42d3-a456-556642440005 -
https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/single/cross-border-credit-transfers/123e4567-e89b-42d3-a456-556642440005 -
https://api-sandbox.rabobank.nl/openapi/sandbox/payments/v1/periodic/cross-border-credit-transfers/123e4567-e89b-42d3-a456-556642440005Each endpoint gives a different response.
Request
X-Request-ID: 7d2da3f9-67d3-5034-b7cc-29f1a05ef1f5
Date: Tue, 24 Jan 2023 06:53:05 GMT
Digest: sha-512=z4PhNX7vuL3xVChQ1m2AB9Yg5AULVxXcg/SpIdNs6c5H0NE8XYXysP+DGNKHfuwvY7kxvUdBeoGlODJ6+SfaPg==
Signature: keyId="474941545142452678797059264714336600071935444114",algorithm="rsa-sha512",headers="date digest x-request-id",signature="k0EwYuRkiHvDt2zx2g9GHz8AzxyVhRuAlAhY0SvHiNrm2tOCpNhwVKoyHHrCa9+CHdLikxGE+r4sTIvD4LwIGhfWGPXUZWCIqczFRVNVZrr4EEmxTzu9tp62BeLdYRqvpIB7K/JGiAzFukqhuYkneQp1cVsT5KWWvoVVHXUcPKTadG0OTBwzfnxGwARum6TWvU9x/TTxcangt+64qrmNAhv7w/EipyzALKN9BNcEzpDxfrAWKeFkjYuReC+ke0RPlxn8T0IM2SVIjehejOS9hgizxi5YhZoB8D6X3qKzktMnCCyhhhXHKowBMmry91wJ4GqtT/yXoHXBnFr6mjkjBw=="
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=
Accept: application/json
Body: Response
{
"creditorAccount": {
"iban": "NL10RABO0123456789"
},
"creditorName": "Company",
"debtorAccount": {
"currency": "EUR",
"iban": "NL10RABO0912345678"
},
"debtorName": "Mason Stevens",
"instructedAmount": {
"content": "10.25",
"currency": "EUR"
},
"creditorAddress": {
"country": "NL",
"streetName": "street-7",
"townName": "Utrecht"
}
}Test Scenarios
We offer predefined scenarios to test happy flows, errors, and edge cases.
POST /sepa-credit-transfers Scenarios
| Scenario | endToEndId/Error message | amt.currency | amt.content | creditorName | credAc.iban | credAc.currency | dbtrAc.iban | dbtrAc.currency | remStrType | remStrIssuer | remStrReference | Remarks |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 201 CREATED | PI-123456789 | EUR | 10.25 | Company | NL10RABO0123456789 | EUR | NL10RABO0912345678 | EUR | SCOR | CUR | 1515140706132013 | |
| 400 Bad Request | PI-123456789 | EUR | 10.25 | Company | EUR | EUR | SCOR | CUR | 1515140706132013 | Send a transfer with leaving one of the fields empty, for example IBAN | ||
| 400 Bad Request | ||||||||||||
| ERROR MESSAGE | PI-123456789 | Paymentfailed response | ||||||||||
| 401 Unauthorised | ||||||||||||
| CERTIFICATE_INVALID | PI-123456789 | Use the value invalid for the header: TPP-Signature-Certificate. | ||||||||||
| 401 Unauthorised | ||||||||||||
| CERTIFICATE_EXPIRED | PI-123456789 | Use the value expired for the header: TPP-Signature-Certificate. | ||||||||||
| 401 Unauthorised | ||||||||||||
| CERTIFICATE_BLOCKED | PI-123456789 | Use the value blocked for the header: TPP-Signature-Certificate. | ||||||||||
| 401 Unauthorised | ||||||||||||
| CERTIFICATE_REVOKED | PI-123456789 | Use the value revoked for the header: TPP-Signature-Certificate. | ||||||||||
| 404 Not Found | PI-123456789 | Change the URL to payments/sepa-credit-transfers | ||||||||||
| 405 Method Not Allowed | PI-123456789 | Use POST instead of GET | ||||||||||
| 503 Service Unavailable | PI-123456789 | Add shown info to EndtoEnd ID in body |
Note: These codes are for Sandbox only.
To create a recurring payment, you need to use the API contains periodic with the following extra content.
| Attribute | Description | Value |
|---|---|---|
| startDate | ISO date | 2023-01-25 |
| endDate | ISO date | 2025-01-25 |
| frequency | Enum value | Monthly |
The difference between single SEPA credit transfer and recurring payment is the startDate and frequency are mandatory. The rest of the scenarios are the same as single SEPA credit transfers.
GET /sepa-credit-transfers/{paymentId}/status Scenarios and GET /cross-border-credit-transfers/{paymentId}/status Scenarios
Some scenarios, as mentioned below, require specific paymentId(s) in the URL.
| Scenario | responseStatus | payment-id | remark |
|---|---|---|---|
| 200 OK | PDNG | 123e4567-e89b-42d3-a456-556642440002 | |
| 200 OK | ACSP | 123e4567-e89b-42d3-a456-556642440003 | |
| 200 OK | RJCT | 123e4567-e89b-42d3-a456-556642440004 | |
| 200 OK | ACSC | 123e4567-e89b-42d3-a456-556642440005 | |
| 200 OK | ACCC | 123e4567-e89b-42d3-a456-556642440006 | |
| 200 OK (Not implemented) | CANC | 123e4567-e89b-42d3-a456-556642440014 | |
| 200 OK | ACSP | 123e4567-e89b-42d3-a456-556642440018 | |
| 200 OK | ACSP | 123e4567-e89b-42d3-a456-556642440020 | |
| 400 BAD REQUEST | 123e4567-e89b-42d3 | PaymentId is not a valid UUID | |
| 400 BAD REQUEST* | 123e4567-e89b-42d3-a456-556642440008 | Header: X-Request-ID (123e4567) is not UUID | |
| 401 Unauthorised | CERTIFICATE_INVALID | 123e4567-e89b-42d3-a456-556642440000 | Use the value invalid for the header: TPP-Signature-Certificate |
| 401 Unauthorised | CERTIFICATE_EXPIRED | 123e4567-e89b-42d3-a456-556642440000 | Use the value expired for the header: TPP-Signature-Certificate |
| 401 Unauthorised | CERTIFICATE_BLOCKED | 123e4567-e89b-42d3-a456-556642440000 | Use the value blocked for the header: TPP-Signature-Certificate |
| 401 Unauthorised | CERTIFICATE_REVOKED | 123e4567-e89b-42d3-a456-556642440000 | Use the value revoked for the header: TPP-Signature-Certificate |
| 404 NOT_FOUND | 123e4567-e89b-42d3-a456-556642440009 | Forced status not found. | |
| 405 Method Not Allowed | 123e4567-e89b-42d3-a456-556642440001 | Use POST instead of GET | |
| 503 SERVICE_UNAVAILABLE | 123e4567-e89b-42d3-a456-556642440010 | Forced service unavailable. |
Note: These codes are for Sandbox only.
GET /sepa-credit-transfers/{paymentId} Scenarios and GET /cross-border-credit-transfers/{paymentId} Scenarios
Some scenarios, as mentioned below, require specific paymentId(s) in the URL.
| Scenario | Remarks | payment-id | amt.currency | amt.content | credAc.iban | credAc.bban | credAc.currency | dbtrAc.iban | dbtrAc.currency | creditorName | debtorName | startDate | frequency |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 200 OK | Single Sepa | 123e4567-e89b-42d3-a456-556642440005 | EUR | 10.25 | NL10RABO0123456789 | EUR | NL10RABO0912345678 | EUR | Company | Mason Stevens | |||
| 200 OK | Single CB IBAN | 6509c408-eb8e-40a5-83d9-05b78cc51009 | GBP | 11.25 | GB60BARC48291709876543 | GBP | NL10RABO0912345678 | EUR | Company1 | Ina Copeland | |||
| 200 OK | Single CB BBAN | 1709c408-eb8e-40a5-83d9-05b78cc51b41 | 11.25 | 02100002112345678901234567 | NL10RABO0912345678 | EUR | Company1 | Ina Copeland | |||||
| 200 OK | Periodic Sepa | 4982e122-57e1-4f3f-b39a-43b50dc734b5 | EUR | 12.25 | NL10RABO0123456789 | EUR | NL10RABO0912345678 | EUR | Company2 | Allen Dawson | 2023-01-25 | Daily | |
| 200 OK | Periodic CB IBAN | 1f22d0e0-a4d5-459f-992e-1ccb4bcbc70e | GBP | 13.25 | GB60BARC48291709876543 | GBP | NL10RABO0123456789 | EUR | Company3 | Logan Bowen | 2023-01-25 | Quarterly | |
| 200 OK | Periodic CB BBAN | 4522d0e0-a4d5-459f-992e-1ccb4bcbc654 | 13.25 | 48291709876543 | NL10RABO0123456789 | EUR | Company3 | Logan Bowen | 2023-01-25 | Quarterly | |||
| 400 Bad Request | 123e4567-e89b-42d3-a456-556642440006 | ||||||||||||
| 404 Not Found | 123e4567-e89b-42d3-a456-556642440007 | ||||||||||||
| 503 Service Unavailable | 123e4567-e89b-42d3-a456-556642440003 |
Note: These codes are for Sandbox only, for testing with the Sandbox example values for Signature add header Date = Tue, 24 Jan 2023 06:53:05 GMT
