Payout Created Webhook

The PAYOUT_CREATED webhook is triggered by a Create Payout request.

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.
- 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 payout, in units defined by payout_currency. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. Same as payout_amount.
- batch_file
- Batch file ID. Relevant to batch payouts that were created via the Client Portal.
- beneficiary
- Object describing the beneficiary.
- beneficiary_country
- Country of the beneficiary. Two-letter ISO 3166-1 ALPHA-2 code.
- created_at
- Time of creation of the payout object, in Unix time.
- error
- Indicates the error code of the last unsuccessful operation on the payout object.
- estimated_time_of_arrival
- The estimated time period in which the beneficiary will receive the funds.
  Note
  Rapyd will try to complete the payout within the estimated time. However, completion of a payout can be delayed for legal or other reasons.
- ewallets
- An array of one object, which contains the following fields:
  ewallet_id
  The ID of the wallet that the money is transferred from, a string starting with ewallet_.
  amount
  Amount of the transaction in currency units defined in currency.
  percent
  A decimal number representing a percentage of the total payout.
- expiration
- Determines the day the payout expires, in Unix time. The payout must be completed before the start of this day.
  Relevant to cash payout methods where the is_expirable field is true in the response to List Payout Method Types.
- fx_rate
- Currency conversion rate for the payout. Decimal.
- gc_error_code
- Reserved.
- id
- ID of the payout. String starting with payout_.
- identifier_type
- Reserved.
- identifier_value
- Reserved.
- instructions
- Describes how the customer collects the payout. Contains the following fields:
  name
  Description of the payment method.
  steps
  An array containing a list of steps for the customer to take. Each step is named stepN, where N is an integer.
- merchant_reference_id
- Identifier defined by the client for reference purposes. Limit: 45 characters.
- metadata
- A JSON object defined by the client. See Metadata.
- paid_amount
- Cumulative amount received by the beneficiary, in units defined by payout_currency.
- paid_at
- Time of the payout, in Unix time.
- payout_currency
- Currency received by the beneficiary. Three-letter ISO 4217 code.
- payout_fees
- Object that defines transaction fees and foreign exchange fees that the client can define for payout transactions.
  transaction_fee
  Describes the fee for processing the transaction.
  calc_type
  Specifies how the fee is calculated. One of the following:
  net - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet.
  gross - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00.
  fee_type
  One of the following:
  percentage - A percentage of the transaction amount. For example, 5 percent is represented by value=5.
  absolute - A fixed amount.
  value
  The amount of the fee.
  fx_fee
  Describes the fees for processing the currency exchange. Relevant to payments with FX.
  calc_type
  Specifies how the fee is calculated. One of the following:
  net - The fee is deducted from the amount paid. For example, in a payment of $100 with a fee of 5%, the recipient receives $95.00 and the $5.00 fee goes to the client wallet.
  gross - The fee is added to the amount paid. For example, for a transaction of $100 with a fee of 5%, the sender pays $105.00.
  value
  The amount of the fee. Percentage.
  gross_fees
  The total gross fees for the transaction, in units defined by currency_code.
  net_fees
  The total net fees for the transaction, in units defined by merchant_requested_currency.
  total_merchant_fees
  The amount of the fee.
- payout_method_type
- The type of payout method. The two-letter prefix must match the country code of the beneficiary.
- payout_type
- The type of the payout method. One of the following values:
  - bank - Payout to bank account.
  - card - Payout to card.
  - cash - Payout to cash.
  - ewallet - Payout to local eWallet.
- sender
- Object describing the sender.
  company_name
  Name of the sender company. Relevant when entity_type is company.
  country
  Country of the sender. Two-letter ISO 3166-1 ALPHA-2 code.
  currency
  Currency that the sender is paying with. Three-letter ISO 4217 code.
  entity_type
  Type of entity. One of the following values:
  company
  individual
  first_name
  First name of the sender. Relevant when entity_type is individual.
  identification_type
  Type of identification document for the sender. When entity_type is company, this field must be company_registered_number. When entity_type is individual, one of the following values:
  drivers_license
  identification_id
  international_passport
  residence_permit
  social_security
  work_permit
  identification_value
  Identification number on the document mentioned in identification_type.
  last_name
  Last name of the sender. Relevant when entity_type is individual.
- sender_amount
- Amount that the sender is paying in units of the currency defined in sender_currency. This amount remains the same regardless of FX fees. Decimal.
- sender_country
- Country of the sender. Two-letter ISO 3166-1 ALPHA-2 code.
- sender_currency
- Currency that the sender is paying with. Three-letter ISO 4217 code.
- statement_descriptor
- A statement that includes the reason for the payout. Limited to 35 characters.
- status
- Indicates the status of the payout. One of the following:
  - Canceled - The payout was canceled.
  - Completed - The beneficiary received some or all payout funds.
  - Confirmation - The payout is waiting for the beneficiary to confirm the FX rate.
  - Created - The payout was created successfully.
  - Declined - The payout failed to pass inspection.
  - Error - The payout was not created or failed after creation.
  - Expired - The payout has expired.
  - Hold - A bank payout is being reviewed manually by Rapyd Protect. A Quarantine Under Review Webhook is also triggered.
  - Pending - The payout is waiting for the beneficiary to confirm acceptance of the funds.

PAYOUT_CREATED Webhook

{
	"id": "wh_063bb1c7039cdca0df36067412ff3590",
	"type": "PAYOUT_CREATED",
	"data": {
		"id": "payout_f7417adbcdca74a986df14a6945903e9",
		"error": null,
		"amount": 2,
		"sender": {
			"id": "sender_7d31896f5f8cdbf68178724a01ca81a3",
			"city": "Copenhagen",
			"name": "Acme",
			"address": "2 Second Avenue",
			"country": "us",
			"currency": "USD",
			"postcode": "67899",
			"entity_type": "company",
			"company_name": "Acme",
			"date_of_birth": "27/09/1980",
			"identification_type": "incorporation_number",
			"identification_value": "123464"
		},
		"status": "Hold",
		"fx_rate": 1.2926705,
		"paid_at": null,
		"ewallets": [
			{
				"amount": 1.55,
				"percent": 100,
				"ewallet_id": "ewallet_c1943cfeda5f98247ab117e5d2648861"
			}
		],
		"metadata": {},
		"batch_file": null,
		"created_at": 1703168448,
		"expiration": null,
		"beneficiary": {
			"id": "beneficiary_63b2e860e9d3e508eefd1c83c32842af",
			"city": "Singapore",
			"iban": "GB29NWBK60161331926819",
			"name": "John Doe",
			"address": "1 First Avenue",
			"country": "SG",
			"currency": "sgd",
			"last_name": "Doe",
			"first_name": "John",
			"entity_type": "individual",
			"payment_type": "priority"
		},
		"paid_amount": 0,
		"payout_fees": null,
		"payout_type": "bank",
		"instructions": [
			{
				"name": "instructions",
				"steps": [
					{
						"step1": "The funds will be transferred to the provided account details of the beneficiary"
					}
				]
			}
		],
		"gc_error_code": "NOT_IMPLEMENTED",
		"sender_amount": 1.55,
		"sender_country": "us",
		"identifier_type": null,
		"payout_currency": "sgd",
		"sender_currency": "USD",
		"identifier_value": null,
		"payout_method_type": "sg_ocbc_bank",
		"beneficiary_country": "SG",
		"statement_descriptor": null,
		"estimated_time_of_arrival": null
	},
	"trigger_operation_id": "7a2ff4b9-2005-4666-abfb-b82bc58515c5",
	"status": "NEW",
	"created_at": 1703168451
}

In this section:

Documentation

Payout Created Webhook

Note

Parameters

Webhook Header Parameters

Webhook Root Parameters

Note

Note

Note

Webhook Data Parameters

Note

Search results