Register IBAN

Registers the IBAN of a customer through a pennydrop proces. The purpose of penny drop is to securely retrieve the customer's IBAN number while minimizing the risk of typographical errors. During the penny drop flow a customer performs a payment of 0.01 € (or in Belgium 0.02€) as a means of authentication. By performing this micro payment Riverty receives information about the customer and their bank details to verify their identity with. For example, to validate if an IBAN really belongs to a specific customer. After completing the payment the charged amount is deducted. Customers complete this payment through iDEAL (NL) or Bancontact (BE). When the time comes, we will use this verified IBAN to execute direct debit charges.

Path

POST /api/v3/customers/{customerNumber}/direct-debit

Request Parameters

customerNumber

required

string

Account number

Request Body

application/json

iban

required in

string

Max length: 34

Iban number

bic

string

Max length: 11

Bic / Swift Code

countryCode

required

string

Enum:

Country code

conversationLanguage

required

string

Enum:

The language code used for client communication. If not provided, the system will default to the language configured for the client.

mandateReference

string

Mandate Reference

contractAcceptedDate

string

yyyy-MM-ddTHH:mm:ss.fffffffzzz

Contract Accepted Date

object

Responses

Successful Request

Request Example

    
        {
 "countryCode": "NL",
 "conversationLanguage": "NL"
}

Response Example

    
        {
 "outcome": "Pending",
 "registrationID": "3237f09b40b9408dbadbccb8d556e8f2",
 "redirectUrl": "https://bank-account.bnpl.riverty.io/bank-account/3237f09b40b9408dbadbccb8d556e8f2",
 "redirectUrlExpirationTime": "2024-05-31T06:49:03Z"
}