Create sandbox accounts
POST/v1/sandbox/accounts
Create a account for use with testing in the sandbox api. customerNumber connects a customer as a owner to this account. However creating an account has different implications for private and corporate users.
Private customers will have this account added automatically to their agreement so it will show up in the account list for the user.
Corporate customers needs to add accounts to agreements explicitly through POST /v1/sandbox/agreements to see the account in the account list.
Request
Header Parameters
- keyId must be formatted as
keyId="SN=XXX,CA=YYY"
whereXXX
is the serial number of the signing certificate in hexadecimal encoding andYYY
is the full Distinguished Name of the Certificate Authority having certificate - algorithm must identify the same algorithm for the signature as presented in the signing certificate and should be
rsa-sha256
- headers must contain
date
,digest
,x-request-id
,psu-id
,psu-corporate-id
, andtpp-redirect-uri
when available - signature must be computed as
Base64(RSA-SHA256(signingString))
Advertises what type of data is actually sent.
Advertises which content types, expressed as MIME types, the client is able to understand. Using content negotiation, the server then selects one of the proposals, uses it and informs the client of its choice with the Content-Type response header.
Advertises which character set the client is able to understand. Using content negotiation, the server then selects one of the proposals, uses it and informs the client of its choice within the Content-Type response header.
Advertises which content encoding, usually a compression algorithm, the client is able to understand. Using content negotiation, the server selects one of the proposals, uses it and informs the client of its choice with the Content-Encoding response header.
Advertises which natural languages the client is able to understand, and which locale variant is preferred. Using content negotiation, the server then selects one of the proposals, uses it and informs the client of its choice with the Content-Language response header.
The domain name of the server (for virtual hosting), and (optionally) the TCP port number on which the server is listening.
Request identifier, unique to the call, as determined by the TPP.
Base64 encoded sha256 or sha512 hash of the message body, used with the signature.
The Digest header is defined by RFC3230 and sha256/sha512 si defined by RFC5843.
The certificate used for signing the request in base64 encoding.
HTTP Message Signature as specified by https://tools.ietf.org/html/draft-cavage-http-signatures-10 with requirements imposed by Berlin Group's NextGenPSD2 Framework.
If any values in the Signature header is ISO-8859-1 or UTF-8 encoded you need to URL encode the Signature header according to RFC 2047 which means MIME encoding the signature.
Also the signature must be wrapped using this format: =?charset?encoding?encoded signature?=
Example of this encoding: =?utf-8?B?a2V5QTQsQ0E9Mi41LjQuOTc9IzB........jMTM1MDUzNDQ0ZTRmMmQ0NjUz?=
Java example of how to implement encoding:
if (charset.equals(StandardCharsets.UTF_8)) {
Signature = String.format("=?utf-8?B?%s?=", Base64.getEncoder().encodeToString(signature.getBytes(StandardCharsets.UTF_8)));
}
- application/json
Body
required
Array [
]
Possible values: [CACC
, CASH
, CHAR
, CISH
, COMM
, CPAC
, LLSV
, LOAN
, MGLD
, MOMA
, NREX
, ODFT
, ONDP
, OTHR
, SACC
, SLRY
, SVGS
, TAXE
, TRAN
, TRAS
]
balances
object[]
required
balanceAmount
object
required
Responses
- 201
- application/json
- Schema
- Example (from schema)
- SandboxAccounts
Schema
Array [
]
Possible values: [CACC
, CASH
, CHAR
, CISH
, COMM
, CPAC
, LLSV
, LOAN
, MGLD
, MOMA
, NREX
, ODFT
, ONDP
, OTHR
, SACC
, SLRY
, SVGS
, TAXE
, TRAN
, TRAS
]
balances
object[]
required
balanceAmount
object
required
Possible values: [closingBooked
, expected
]
_links
object
required
self
object
required
transactions
object
required
{
"id": "enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD",
"customerNumber": "01085800481",
"accountName": "kontotest",
"bban": "91351631959",
"iban": "NO8591351631959",
"currency": "NOK",
"product": "TEST PRODUKT",
"cashAccountType": "CACC",
"creditLine": 0,
"balances": [
{
"balanceAmount": {
"amount": 10000,
"currency": "NOK"
},
"balanceType": "expected"
}
],
"_links": {
"self": {
"href": "/v1/sandbox/accounts/enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD",
"verbs": [
"GET",
"DELETE"
]
},
"transactions": {
"href": "/v1/sandbox/accounts/enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD/transactions",
"verbs": [
"GET",
"POST",
"DELETE"
]
}
}
}
{
"id": "enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD",
"customerNumber": "01085800481",
"accountName": "kontotest",
"bban": "91351631959",
"iban": "NO8591351631959",
"currency": "NOK",
"product": "TEST PRODUKT",
"cashAccountType": "CACC",
"creditLine": 0,
"balances": [
{
"balanceAmount": {
"amount": 10000,
"currency": "NOK"
},
"balanceType": "expected"
}
],
"_links": {
"self": {
"href": "/v1/sandbox/accounts/enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD",
"verbs": [
"GET",
"DELETE"
]
},
"transactions": {
"href": "/v1/sandbox/accounts/enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD/transactions",
"verbs": [
"GET",
"POST",
"DELETE"
]
},
"balances": {
"title": "BalancesLink",
"type": "object",
"description": "Update balances link",
"properties": {
"href": {
"type": "string"
},
"verbs": {
"type": "array",
"items": {
"type": "string",
"enum": [
"PUT"
]
}
}
},
"required": [
"href",
"verbs"
],
"example": {
"href": "/v1/sandbox/accounts/enc!!90hSjpSdpeftHiDSYiPaHVGoKHriD-6ARR4JlXcEebYbYa_WNwJvqevSrba4WtnD/balances",
"verbs": [
"PUT"
]
}
}
}
}