Introduction

Card transaction refund

The request webhook is triggered when the transaction was canceled therefore the amount has been refund.

The request is composed by the following fields:

PRODUCT: CARDS

EVENT TYPE: REFUND

STATUS: SUCCESS

Data Payload:

Title

Description

Title

Field	Type	Description
card_id	String	Unique identifier of the card that needs the approval
bill_amount	Decimal with 2 digit precision	Amount of the operation will be billed on the system. Since all our cards are issued on USD, all transactions on the field will be on US Dollar
bill_currency_number	Number	Currency expressed on ISO 4217 format
bill_currency_code	String	Currency short name
transaction_amount	Decimal with 2 digit precision	Amount of the operation that client is going to spend. This is the same value as show on the checkout/POS
transaction_currency_number	Number	Currency expressed on ISO 4217 format
transaction_currency_code	String	Currency short name
exchange_rate	Number	If applied, the conversion rate applied to the amout. If not null will be sent.
channel	String	Name of the channel where the transaction is being made. Possible values `ATM`, `POS`, `ECOMMERCE` or `Visa Direct`
created_at	Date Time	Date and time when the transaction was created
fees	Object	Information about the fees that are involved in the transaction
merchant_data	Object	Information about the merchant that is involved in the transaction

Fees payload:

Title

Description

Title

Field	Type	Description
atm_fees	Decimal with 2 digit precision	ATM fee charged to the transaction, if apply. Zero if no cost is incurred
fx_fees	Decimal with 2 digit precision	Currency conversion fee charged to the transaction, if apply. Zero if no cost is incurred

Merchant payload:

Title

Description

Title

Field	Type	Description
id	String	Unique identifier of the merchant
name	String	Registered of the merchant
city	String	City where the merchant is registered, could be null
post_code	String	Postal code where the merchant is registered, could be null
state	String	State where the merchant is registered, could be null
country	String	Country where the merchant is registered. The country name is represented in 3 letter format ISO 3166-1 alpha-3.
mcc_category	String	Category name that the merchant has be registered
mcc_code	String	Numeric code of the category that merchant has be registered

Full payload example:

Plain text

 {
  "product": "CARDS",
  "event_type": "REFUND",
  "operation_id": "ca0c57d2-b1c9-4bcd-9d5d-8d361cad6fddds1c",
  "status": "SUCCESS",
  "data": {
    "card_id": "ivZPARvNBLOSZx69q4DCBBGUfVhCMsLw",
    "amount": 100.2,
    "currency_number": 840,
    "currency_code": "USD",
    "exchange_rate": null,
    "channel": "ECOMMERCE",
    "created_at": "2024-05-15T21:38:57.677Z",
    "fees": {
      "atm_fees": 0,
      "fx_fees": 0
    },
    "merchant_data": {
      "id": "311178830000",
      "name": "Amazon Es",
      "city": "Barcelona",
      "post_code": "16633",
      "state": "Cataluña",
      "country": "ESP",
      "mcc_category": "Electronics Stores",
      "mcc_code": "5732"
    }
  }
}

Response:

No response is need it.

Payload example:

Plain text

{}

Sections

Card transaction refund

Data Payload:

Field

Type

Description

Fees payload:

Field

Type

Description

Merchant payload:

Field

Type

Description

Full payload example:

Response:

Payload example:

What made this section unhelpful for you?

On this page