Skip to main content

Welcome to our Dev Docs!

Payment transaction

PaymentTransactio.PNG

Billwerk+ Enterprise not only automates recurring invoices but also regular payments.

You simply configure the payment provider(s) of your choice in your Billwerk+ Enterprise account and the corresponding means of payment are already available to you.

Billwerk+ Enterprise has integrated various payment service providers (PSP - Payment Service Provider) for this purpose. With this integration Billwerk+ Enterprise not only triggers payments automatically, but also receives - if the payment providers support this - information about chargebacks or refunds.

The payment transaction contains all data and the status history of an individual payment transaction with a payment service provider. The attributes are:

  • Amount,

  • Status history,

  • Current status,

  • Time of the last status change,

  • Trigger of the transaction,

  • Specific data of the payment provider

If a payment is captured manually without a payment service provider being involved, there is an entry in the Contract ledger for this payment, but no payment transaction.

Example
{
    "InvoiceReferenceCode":"XFHNJ-LZHHL-GFCBS",
    "InvoiceId":"5b960ddd88472d07fc704bf9",
    "Id":"5b960e2a88472c05603cdb22",
    "PaymentProvider":"FakeProvider",
    "PaymentProviderRole":"Debit",
    "Trigger":"Signup",
    "CustomerId":"5b960dd488472d07fc704bdd",
    "CustomerName":"Ehrlich, Alyssa",
    "ContractId":"5b960dd488472d07fc704bde",
    "ProviderTransactionId":"8b47fb14-fef7-4250-b4ad-9784d74da9c7",
    "StatusHistory":[
        {
            "Status":"InProgress",
            "Timestamp":"2018-09-10T06:24:42.9910000Z",
            "Amount":89.25,
            "HttpCode":0,
            "Preauth":false
        },
        {
            "Status":"Succeeded",
            "Timestamp":"2018-09-10T06:24:44.9940000Z",
            "Amount":89.25,
            "HttpCode":0,
            "Preauth":false
        }
    ],
    "Status":{
            "Status":"Succeeded",
            "Timestamp":"2018-09-10T06:24:44.9940000Z",
            "Amount":89.25,
            "HttpCode":0,
            "Preauth":false
        },
        "Amount":89.25,
        "Currency":"EUR",
        "StatusTimestamp":"2018-09-10T06:24:44.9940000Z",
        "ConfirmedAt":"2018-09-10T06:24:45.0140000Z",
        "Preauth":false
}
In this section: