Bavindo
  1. NFC
Bavindo
Webhook
  • API
  • Webhook
  • v1
    • Payment
      • POS Payment event webhook
      • POS Payment display webhook
    • NFC
      • NFC Transaction event webhook
        POST
  1. NFC

NFC Transaction event webhook

Developing
POST
https://api.bavindo.comhttps://your.domain.com/your/endpoint

Recieving asynchronous NFC Transaction responses#

When using the asynchronous method in the creation of a NFC Transaction you need to use the event webhooks to get the result of the NFC Transaction.

Payload#

The Adyen payload is wrapped in our own payload (adyen_payload), for extra information on these payloads please refer to the Adyen docs.

Response event statuses#

success The NFC Transaction was successful on the terminal.
failure The NFC Transaction had an error.
INFO
Please refer to Responses -> Webhook payload for a detailed scheme of the payload of the event webhook

Request

None

Responses

🟢200Webhook payload
application/json
Body
event_type
string 
required
The Adyen event type
Example:
service.payment.response
event
string 
required
The status of the payment
Examples:
successfailure
event_condition
string  | null 
required
If event == failed a reason will be provided
store_id
string 
required
The Store ID associated with the Payment
terminal_id
string 
required
The ID of the pysical Adyen terminal associated with the Payment
pos_id
string 
required
The ID of your POS unit
metadata
object  | null 
required
The metadata provided with with creation of the payment
your_info
string 
required
adyen_payload
object 
required
The raw Adyen event payload
SaleToPOIResponse
object 
required
environment
string 
required
The environment of where the payment resides
Examples:
testlive
Example
{
    "event_type": "service.cardacquisition.response",
    "event": "success",
    "event_condition": null,
    "store_id": "3294V22322755KZ6TWHGPRJ",
    "terminal_id": "P400Plus-000000000",
    "pos_id": "willekeurig",
    "metadata": {
        "your_info": "123456789"
    },
    "adyen_payload": {
        "SaleToPOIResponse": {
            "CardAcquisitionResponse": {
                "POIData": {
                    "POIReconciliationID": "1000",
                    "POITransactionID": {
                        "TimeStamp": "2024-11-12T18:28:10.362Z",
                        "TransactionID": "ZRpg001731436090001"
                    }
                },
                "PaymentInstrumentData": {
                    "CardData": [],
                    "PaymentInstrumentType": "Card"
                },
                "Response": {
                    "AdditionalResponse": {
                        "NFC_uid": "06246E32",
                        "NFC_variant": "mf_classic",
                        "giftcardIndicator": "false",
                        "iso8601TxDate": "2024-11-12T18:28:10.362Z",
                        "merchantReference": "78fc5a1d-b5c5-46b2-b505-a08b6580",
                        "message": "CARD_ACQ_COMPLETED",
                        "posAmountCashbackValue": "0",
                        "posAmountGratuityValue": "0",
                        "posAuthAmountCurrency": "EUR",
                        "posAuthAmountValue": "0",
                        "posEntryMode": "CLESS_SWIPE",
                        "posOriginalAmountValue": "0",
                        "posadditionalamounts_originalAmountCurrency": "EUR",
                        "store": "3294V22322755KZ6TWHGPRJ",
                        "tid": "38001144",
                        "transactionType": "GOODS_SERVICES",
                        "txdate": "12-11-2024",
                        "txtime": "19:28:10"
                    },
                    "Result": "Success"
                },
                "SaleData": {
                    "SaleTransactionID": {
                        "TimeStamp": "2024-11-12T18:28:08.000Z",
                        "TransactionID": "78fc5a1d-b5c5-46b2-b505-a08b6580"
                    }
                }
            },
            "MessageHeader": {
                "MessageCategory": "CardAcquisition",
                "MessageClass": "Service",
                "MessageType": "Response",
                "POIID": "P400Plus-000000000",
                "ProtocolVersion": "3.0",
                "SaleID": "willekeurig",
                "ServiceID": "0f85a307"
            }
        }
    },
    "environment": "test"
}
Modified at 2024-10-21 12:25:08
Previous
POS Payment display webhook
Built with