Skip to main content

SafetyPay Payment Notification

JSON payment notification sent to the business partner.

timestampinteger<int64>required

Unix timestamp in milliseconds indicating the time of the card assignment event.

Example: 1607017210793
eventTypestringrequired

Event type that triggered the payment notification.

Example: ASSIGN_CARDS
versionstringrequired

API version number.

Example: 1
data objectrequired

Transaction data included in the payment notification.

midstringrequired

Ten-digit merchant ID.

Example: 1100000000
customer objectrequired

Customer data included in the payment notification.

idstringrequired

Unique customer identifier provided by the business partner.

Example: kfoLkCq3RBIJiJF6sJWBeYA4tnfsCms2
payment_idstringrequired

Payment identifier.

Example: pay_1100000000_XdyBD9FuEJVhpX3hctwJzCB8w1rEzgTo_USD
payment_instrumentstringrequired

Payment method used for the transaction.

Possible values: [paysafecard, safetypay]

Example: safetypay
payment_instrument_subtypestringrequired

Type of payment option used for the transaction.

Possible values: [cash, online]

Example: cash
bank_idstring

Identifier of the bank used for a SafetyPay transaction.

The source documentation states that PaysafeCard should be contacted if this parameter is required.

Example: 9999
card_details object[]required

Details of the cards used for the transaction.

A maximum of ten card-detail entries can be returned for a single transaction.

Possible values: <= 10

  • Array [
  • serialstringrequired

    Serial number identifying the card.

    Example: 1420271325
    currencystringrequired

    Three-letter ISO 4217 currency code of the card.

    Possible values: >= 3 characters and <= 3 characters

    Example: USD
    amountnumber<double>required

    Amount used from the card, with two decimal places.

    Example: 10
    typestringrequired

    Five-character code identifying the card type.

    Possible values: >= 5 characters and <= 5 characters

    Example: 00094
    countrystringrequired

    Two-letter ISO 3166-1 country code of the card.

    Possible values: >= 2 characters and <= 2 characters

    Example: XX
  • ]
  • SafetyPay Payment Notification
    {
    "timestamp": 1607017210793,
    "eventType": "ASSIGN_CARDS",
    "version": "1",
    "data": {
    "mid": "1100000000",
    "customer": {
    "id": "kfoLkCq3RBIJiJF6sJWBeYA4tnfsCms2"
    },
    "payment_id": "pay_1100000000_XdyBD9FuEJVhpX3hctwJzCB8w1rEzgTo_USD",
    "payment_instrument": "safetypay",
    "payment_instrument_subtype": "cash",
    "bank_id": "9999",
    "card_details": [
    {
    "serial": "1420271325",
    "currency": "USD",
    "amount": 10,
    "type": "00094",
    "country": "XX"
    }
    ]
    }
    }