zimpler-developers

Withdrawal to Company account

This type of withdrawal enables payouts to companies. The iban number to where the money should be transferred is to be included within the request. Since there’s no end-user involved no KYC will be performed. Therefore it is of high importance that you verify the iban account number before adding it into your request.

For now it’s only available in Sweden which means that the country-code is restricted to be “SE” and the currency to be “SEK”.

Flow

# POST /v4/company_withdrawals

# REQUEST

{
    // required
    "amount": "1.00",
    "bank-account": {
        "type": "iban",
        "account-number": "SE0000000000000000000000"
    },
    "country-code": "SE",
    "currency": "SEK",
    "ref": "merchant-transaction-ref"
    "site_display_name": "Best Website.com",
    "site": "example.com",
    // optional
    "account-ref": "PlayerRef1234",
}

# RESPONSES

All responses will include the full withdrawal object sent within your request. This is pointed out with the […] in below documentation.

The state will always be approved since no KYC is being performed.

{
    ...
    "id" : "66b396a5-6e4e-4d3f-b3c3-1ef69d0f9875",
    "state" : "approved",
    "created_at" : "2021-02-04T07:30:49Z"
}

# GET /v4/company_withdrawals/:id

Will return the current state of the withdrawal.