Skip to main content

Transaction update event

POST 

/transactions/events

This webhook will be sent when the status of all transaction types is updated - deposit, withdrawal or transfers.

Request

Header Parameters

    Signature string

    HMAC signature of the request

    Content-Type stringrequired

    Default value: application/json

    application/json

Body

    id stringrequired

    Change identifier.

    timestamp date-timerequired

    Represents RFC 3339, section 5.6 date-time.

    operationType OperationType (string)required

    Possible values: [Update, Create, Delete]

    Type of the notification event:

    • Insert - Denotes insert operation.
    • Update - Denotes update operation. The entity should contain only updated fields.
    • Delete - Denotes delete operation.

    transaction

    object

    required

    Transaction update information.

    id stringrequired

    Transaction id

    slipId stringrequired

    Transaction Slip Id.

    customerId stringrequired

    Wallet customer id.

    accountId stringrequired

    Account Id associated with this transaction.

    type TransactionType (string)required

    Possible values: [DEPOSIT, WITHDRAWAL, CHARGEBACK_REVERSAL, RETURNED_WITHDRAWAL, CHARGEBACK, MERCHANT_FEE, TRANSACTION_FEE, DAILY_TRANSACTIONS_FEE, TRANSFER_IN, TRANSFER_OUT, TRANSFER_RETURN, REFUND, CURRENCY_EXCHANGE, PAYSAFE_FEE, PREPAID_CARD, PREPAID_CARD_AUTHORIZATION, APPLICATION_FEE, SET_UP_FEE, MONTHLY_MAINTENANCE_FEE]

    amount int64required

    Transaction amount in minor units.

    currencyCode Currency (string)required

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

    Currency alphabetic code as specified by ISO 4217

    creationTime date-timerequired

    Represents RFC 3339, section 5.6 date-time.

    direction stringrequired

    Possible values: [CREDIT, DEBIT]

    Transaction direction.

    paymentType PaymentType (string)

    Possible values: [CARD, BANK_TRANSFER, RAPID_TRANSFER, TRANSFER]

    Type of instrument. Used as discriminator for different Payment types.

    • CARD
    • BANK_TRANSFER
    • RAPID_TRANSFER
    • TRANSFER
    instrumentId string
    instrumentType InstrumentType (string)

    Possible values: [SEPA_BANK_ACCOUNT, UK_BANK_ACCOUNT, US_BANK_ACCOUNT, CCI_BANK_ACCOUNT, CARD]

    Instrument type.

    | Value | Description| |---|---| | SEPA_BANK_ACCOUNT| SEPA Bank account | | UK_BANK_ACCOUNT | UK Bank account | | US_BANK_ACCOUNT | US Bank account | | CCI_BANK_ACCOUNT | CCI Bank account | | CARD | Card |

    status TransactionStatus (string)required

    Possible values: [PENDING, PROCESSING, COMPLETED, FAILED, CANCELLED, REFUNDED, DECLINED]

    The transaction status:

    • PENDING - Transaction is created and further action is required by the customer.
    • PROCESSING - Transaction is scheduled for processing by the payment provider.
    • COMPLETED - Transaction is completed. Note that some transactions might be completed from Embedded Wallet point of view, but not from customer point of view, since money movement might take some time outside of the Embedded Wallet network.
    • FAILED - Transaction is failed. Check STATUS_REASON property for details.
    • CANCELLED - Transaction have been cancelled
    • REFUNDED - Valid only for deposit transactions.
    • DECLINED - transaction is declined.
    statusReason string

    Status reason for FAILED transactions. See TransactionStatusReason for available values.

    merchantRefNum string

    Merchant reference number associated witht the transaction.

    recipientReference string

    Additional reference information for the recipient passed by the sender of the transaction. This information is not valid or present for all transaction types.

Responses

OK

Loading...