Refund Rejected Webhook

The PAYMENT_REFUND_REJECTED webhook is sent when Rapyd rejects a refund. The status is set to Rejected.

Parameters

Webhook Header Parameters

Webhook Root Parameters

- created_at
- Time that the webhook was created, in Unix time.
  Note
  Inside the data object, some webhooks have another created_at field that refers to a different event.
- data
- Contains the actual data of the webhook.
  For details, see below.
- extended_timestamp
- Time in milliseconds that the webhook was created, in Unix time.
- id
- ID of the webhook. String starting with wh_.
- status
- Status of the webhook. One of the following:
  - NEW
  - CLO - Closed.
  - ERR - Error.
  - RET - Re-sent.
  Note
  Inside the data object, some webhooks have another status field that refers to a different event.
- trigger_operation_id
- ID of the operation that triggered the webhook. UUID.
- type
- Name of the webhook type.
  Note
  The name in the Client Portal is different.

Webhook Data Parameters

- amount
- Amount of the refund, in units defined by currency in the original payment.
- created_at
- Time of creation of this refund, in Unix time.
- currency
- The currency of the amount received by the original payment source. Three-letter ISO 4217 code.
- ewallets
- Array of objects that define the allocation of the refund to multiple wallets.
  ewallet
  ID of the wallet, a string starting with ewallet_.
  amount
  The amount refunded to this wallet. Relevant when percentage is not set.
  percentage
  The percentage of this payment refunded to this wallet. Relevant when amount is not set.
- failure_code
- Indicates the reason that the refund failed. See Card Network Errors.
- failure_reason
- Indicates the reason that the refund failed. One of the following:
  - lost_or_stolen_card
  - expired_or_canceled_card
  - unknown
  - Empty string
- fixed_side
- Indicates which side of the transaction the FX rate is fixed for. Relevant for refunds with foreign exchange. One of the following values:
  - buy
  - sell
- fx_rate
- Exchange rate for the transaction.
  - When fixed_side is buy, fx_rate is the buy rate.
  - When fixed_side is sell, fx_rate is the sell rate.
  Decimal number as string. Relevant to refunds with foreign exchange.
- id
- ID of the refund object. String starting with refund_.
- merchant_reference_id
- Identifier defined by the client for reference purposes. Limit: 45 characters.
- merchant_debited_amount
- Amount debited from the merchant. Relevant to refunds with foreign exchange.
- merchant_debited_currency
- Indicates the currency that is debited from the merchant. Three-letter ISO 4217 code. Relevant to refunds with foreign exchange.
- merchant_ewallet
- As a Payment Facilitator (PayFac), you can create a card payment and direct the funds that the sub-merchant collects to your client wallet.
  Relevant to a PayFac.
- metadata
- A JSON object defined by the client. See Metadata.
- payment
- ID of the payment object that the refund is credited against. String starting with payment_.
- payment_created_at
- Time that the original payment was created, in Unix time.
- payment_method_type
- The original payment method type. Use List Payment Methods by Country for a list of supported types for a country.
- proportional_refund
- Indicates whether the refund was returned in proportion to the amounts received by the wallets in the payment. Relevant to a refund for a payment split among multiple wallets.
- reason
- Description of the reason for the refund, provided by the merchant.
- receipt_number
- Number of the receipt for the refund, provided by the merchant.
- status
- Indicates the status of the refund operation. One of the following values:
  - Completed - The refund was complete.
  - Error - The refund failed since the payment object on which the refund is based is not in closed status.
  - Rejected - The refund was rejected by the specific payment processor for this payment.
  - Pending - The request created a refund object on the Rapyd platform, but the refund is not yet complete. For example, the refund is for a payment method that requires a customer action, such as cash, bank redirect or bank transfer.
- - updated_at
  - Time that this refund was last updated, in Unix time.

PAYMENT_REFUND_REJECTED Webhook

{
  "id": "14f48d8e-364e-42de-85e8-3bc8f12c4955",
  "token": "wh_fa09cfc608c98b4cee61b5e061089d99",
  "organization_id": "bf3e8659-9bec-11e9-8e70-0e88f99c694e",
  "org_pk": 0,
  "type": "PAYMENT_REFUND_REJECTED",
  "data": {
    "id": "refund_3dcc1b83b83b49ee732e7fe62368ed9a",
    "amount": 8.6,
    "payment": "payment_1b31ec2b184d9f098b128caa65c4d837",
    "currency": "USD",
    "failure_reason": "",
    "failure_code": "",
    "metadata": {},
    "reason": "",
    "status": "Rejected",
    "receipt_number": 0,
    "created_at": 1768811,
    "updated_at": 1768811,
    "merchant_ewallet": null,
    "merchant_reference_id": "",
    "payment_created_at": 1768809,
    "payment_method_type": "id_mandiri_redirect_bank",
    "ewallets": [
      {
        "ewallet": "ewallet_e2150f478c15d97b807b9ed179b798a0",
        "amount": 8.6
      }
    ],
    "proportional_refund": true,
    "merchant_debited_amount": null,
    "merchant_debited_currency": null,
    "fx_rate": null,
    "fixed_side": null
  },
  "attempts": [],
  "trigger_operation_id": "8d1fb194-a393-4bda-aead-78f69473cf8a",
  "first_attempt_at": 0,
  "last_attempt_at": 0,
  "status": "",
  "created_at": 0,
  "next_attempt_at": 0,
  "uri": ""
}

In this section:

Documentation

Refund Rejected Webhook

Parameters

Webhook Header Parameters

Webhook Root Parameters

Note

Note

Note

Webhook Data Parameters

Search results