# Receiving DirectBilling transaction information

# Signature

## Calculating the signature when receiving a notification
We generate the signature by combining all the parameters received (except for the signature) to the API in the order from the table above, separating them with a | separator and adding at the end the key available in the customer panel in the service. 
Hashing must be done using sha256. 
Example: 


The notification is sent using the  method and requires you to respond in the body with  and Http Code 


Endpoint: POST directbillingTransactionNotification
Version: 1.0.0

## Request fields (application/json):

  - `id` (string, required)
    Transaction ID

  - `serviceId` (string, required)
    Service ID

  - `status` (string, required)
    Transaction status
    Enum: "transaction_db_new", "transaction_db_confirmed", "transaction_db_payed", "transaction_db_rejected"

  - `values` (object, required)
    Transaction amounts
    Example: {"net":11.07,"gross":13.61,"partner":5}

  - `values.net` (number, required)
    Net transaction amount
    Example: 11.07

  - `values.gross` (number, required)
    Gross transaction amount
    Example: 13.61

  - `values.partner` (number, required)
    Partner's commission from the transaction
    Example: 5

  - `returns` (object)
    Example: {"complete":"https://www.simpay.pl/complete","failure":"https://www.simpay.pl/failure"}

  - `returns.complete` (string)
    Address to which the customer should be redirected after a successful transaction
    Example: "https://www.simpay.pl/complete"

  - `returns.failure` (string)
    Address to which the customer should be redirected after an unsuccessful transaction
    Example: "https://www.simpay.pl/failure"

  - `control` (string)

  - `number_from` (string, required)
    Phone number from which the transaction was made
    Example: "48123123123"

  - `provider` (integer, required)
    Example: 1

  - `signature` (string, required)
    Signature of the notification [Read how to generate the signature](#tag/DirectBilling/Sygnatura/Obliczanie-sygnatury-przy-odbieraniu-notyfikacji)
    Example: "a3116cf4f1e960223c2cc3088bf387278b6675255209bdeaf96a2f316a2fadc1"