Real-time CCB

>>>

POST /api/:provider/bill_lines
Create a bill line

Import credit card transaction into Bezala as a bill line.

Authorization header is required to use Bearer schema, and must contain a JWT token signed using EdDSA algorithm. The token’s payload must contain:

  • aud claim set to “Bezala”;
  • iss claim set to provider name.

Supported Formats

json

Errors

Code Description
403 Authorization failed.
404 Provider not found by name, or active integration not found by company's business ID for the given provider.
422 Required parameter(s) missing.

Params

Param name Description
transaction
required

Validations:

  • Must be a Hash
transaction[linkID]
required

Unique transaction identifier. Allows pushing data for the same transaction multiple times, for instance as it travels through different states (from authed to cleared, from authed to rejected etc).

Validations:

  • Must be a String
transaction[status]
required

Transaction state. If a transaction is rejected or expired, the corresponding bill line will be deleted from Bezala.

Validations:

  • Must be one of: authed, cleared, rejected, expired.
transaction[text]
optional

Additional information, used as bill line’s description in Bezala (e.g. vendor name).

Validations:

  • Must be a String
transaction[time]
optional

Timestamp, e.g. “2023-06-30T14:30:12+0:00”

Validations:

  • Must be a String
transaction[amount]
required

Validations:

  • Must be a Hash
transaction[amount][amount]
required

Original amount as a decimal number with a minus sign. For example, for a 5.00 EUR expense, the “amount” should be set to “-5.00”.

Validations:

  • Must be a String
transaction[amount][currency]
required

Original currency code: “EUR”, “SEK” etc.

Validations:

  • Must be a String
transaction[settlementAmount]
required

Validations:

  • Must be a Hash
transaction[settlementAmount][amount]
required

Billed amount as a decimal number with a minus sign. For example, for a 5.00 EUR expense, the “amount” should be set to “-5.00”.

Validations:

  • Must be a String
transaction[settlementAmount][currency]
required

Billed currency code: “EUR”, “SEK” etc.

Validations:

  • Must be a String
transaction[card]
required

Validations:

  • Must be a Hash
transaction[card][firstFour]
required

Credit card’s first four digits, e.g. “5555”.

Validations:

  • Must be a String
transaction[card][lastFour]
required

Credit card’s last four digits, e.g. “4444”.

Validations:

  • Must be a String
transaction[card][userOrganization]
required

Validations:

  • Must be a Hash
transaction[card][userOrganization][email]
required

Cardholder’s email. Used to find Bezala user for an imported transaction.

Validations:

  • Must be a String
transaction[card][userOrganization][organization]
required

Validations:

  • Must be a Hash
transaction[card][userOrganization][organization][businessID]
required

Company’s business ID, e.g. “1234567-1”. Used to find the company for an imported transaction.

Validations:

  • Must be a String

Returns

Code: 201

Description:

Created

Param name Description