Select account information
# Flow
Note: Make sure to load the user_form_url
in a redirect or popup on
mobile, loading user_form_url
in an iframe on mobile will cause
issues.
# POST /v4/accounts
# REQUEST
{
// required
"country_code": "SE",
"ref": "merchant-transaction-ref",
"site_display_name": "Best Website.com",
"site": "example.com",
"success_url": "https://example.com/return_path/transaction_identifier",
"close_url": "https://example.com/return_path/transaction_identifier",
"failure_url": "https://example.com/return_path/transaction_identifier",
// optional
"notification_url": "https://example.com/return_path/transaction_identifier",
"account_ref": "CustomerRefOnMerchantSide",
"email": "bobben@example.com",
"locale": "sv",
"mobile_phone": "+46700000000",
"national_identification_number": "19810101-9999",
"user_id": "f65191e4-3064-cc45-df68-8130e4a11197",
"bank_account": {
"type": "bic",
"bic": "SWEDSESS"
},
}
# RESPONSES
All responses will include the full accounts object sent within your request. This is pointed out with the […] in below documentation.
{
...
"id": "6a734480-a051-4a05-8405-ac2d8f49102f",
"state": "pending",
"user_form_url": "https://account-sandbox.zimpler.com?code=6a734480-a051-4a05-8405-ac2d8f49102f",
"user_id": null,
}
{
...
"id": "6a734480-a051-4a05-8405-ac2d8f49102f",
"state": "approved",
"user_id": "f65191e4-3064-cc45-df68-8130e4a11197",
"kyc_info": {
"country_code": "SE",
"date_of_birth": "1981-01-01",
"first_name": "Henrik Testperson",
"last_name": "Testson",
"national_identification_number": "19810101-9999",
"pep": false,
"user_id": "f65191e4-3064-cc45-df68-8130e4a11197",
"user_ip": "129.128.10.11",
"address": {
"city": "Sundbyberg",
"country": "Sweden",
"line_1": "Box 1529 / Prod Utv",
"line_2": null,
"postcode": "17229",
}
},
//will be provided or partial provided depending on the information we recive.
"account_information": [
{
"type": "iban",
"account_number": "XXX",
},
{
"type": "national-SE",
"clearing_number": "XXX",
"account_number": "XXX",
},
{
"type": "bic",
"bic": "ELLFSESS"
}
{
"type": "holder_name",
"first_name": "Henrik Testperson",
"last_name": "Testson"
}
],
}
# GET /v4/accounts/:id
Will return the full accounts information object with the current state.