Sign in

v1

latestOpenAPI 3.0.0UNLICENSED2026-07-26178479713.7 KB
transactions

aid_cards_cardid_transactions_void_post

Void a pending Transaction by unlocking the amount withheld by the pending transaction

scopes:

  • admin:wallets
  • write:wallets
  • write:wallets:/transactions
post/accounts/{aid}/wallets/transactions/{transaction_id}/void

Path parameters

aidstring ^[PT]{1}\d{8}$ required

An id that uniquely identifies the account.

transaction_idstring uuid required

An id that uniqely idetifies a transaction

Request body

metadataobject

A key-value JSON object to store any additional information. The dintero_* namespace for keys is reserved

ref_idstring required

Unique ref ID provided by the client to support safely retrying requests without accidentally performing the same operation twice

All card transaction must have a unique ref ID, but it is not required that the ref ID is globally unique.

Example request

{
  "metadata": {
    "order_id": "xk39592f"
  }
}

Response

Transaction voided

idstring

An ID that uniquely identifies the resource

created_atstring date-time

When the transaction was created

payment_product'bambora' | 'collector' | 'dintero' | 'dintero_psp' | 'instabank' | 'klarna' | 'netaxept' | 'payex' | 'santander' | 'swish' | 'vipps' | 'kravia' | 'two' | 'seitatech' required

The payment product corresponding to this transaction

payment_product_type'bambora.applepay' | 'bambora.creditcard' | 'bambora.googlepay' | 'bambora.mobilepay' | 'bambora.vipps' | 'collector.invoice' | 'collector.invoice_b2b' | 'collector.invoice_b2b_preapproved' | 'collector.installment' | 'dintero.zero' | 'dintero.wallets' | 'dintero.external' | 'dintero_psp.creditcard' | 'dintero_psp.vipps' | 'dintero_psp.googlepay' | 'dintero_psp.applepay' | 'dintero_psp.clicktopay' | 'instabank.finance' | 'instabank.invoice' | 'instabank.installment' | 'instabank.postponement' | 'klarna.klarna' | 'klarna.billie' | 'kravia.invoice_b2b' | 'kravia.invoice_b2b_grouped' | 'kravia.invoice_b2c' | 'two.invoice_b2b' | 'netaxept.creditcard' | 'payex.creditcard' | 'payex.mobilepay' | 'payex.swish' | 'payex.vipps' | 'payex.applepay' | 'payex.clicktopay' | 'payex.googlepay' | 'santander.debit_account' | 'seitatech.in_person' | 'swish.swish' | 'vipps' required

The payment product type corresponding to this transaction

amountinteger required

Non-negative, minor units. Total amount of the transaction

currencystring iso4217-code required

ISO 4217 transaction currency

payout_destination_idstring

An id that identifies the seller, value will be included in the settlement reports

merchant_referencestring

A reference specified by the merchant to identify the transaction

channel'ecommerce' | 'in_app' | 'in_store'

The channel for the transaction

platform_type'aggregator' | 'marketplace'

Type of platform the merchant is.

merchant_reference_2string

A reference specified by the merchant to identify the transaction, can be updated after the transaction has been created

dynamic_descriptorstring

A short reference / descriptor that will show up on the customers bank statement

payment_operation'unscheduled_purchase' | 'recurring_purchase' | 'generate_payment_token'

Initiated by the merchant or used to generate a token

settlement_status'NOT_SETTLED' | 'PENDING_SETTLEMENT' | 'PARTIALLY_SETTLED' | 'SETTLED'

Overall settlement status after the events

customer_ipstring

The IP address of the customer

user_agentstring

The full user agent string of the device the customer used to submit the transaction

status'INITIATED' | 'AUTHORIZED' | 'AUTHORIZATION_VOIDED' | 'CAPTURED' | 'PARTIALLY_CAPTURED' | 'PARTIALLY_CAPTURED_REFUNDED' | 'REFUNDED' | 'PARTIALLY_REFUNDED' | 'DECLINED' | 'FAILED' | 'UNKNOWN' | 'ON_HOLD'

The current status of the transaction

session_idstring

The session id for the transaction

updated_atstring date-time

When the transaction was last modified.