--- title: "Swift receive credit" method: POST path: "swift-in#credit" tags: ["webhook-event"] --- # Swift receive credit `POST swift-in#credit` (webhook) Triggered every time a SWIFT message is received and a credit is deposited into a balance account. If you also subscribe to `balances#credit` or `transfers#state-change` on the same profile or application, you may experience some duplication of webhook events. You should make allowances for this to handle it in your implementation. * Event type: `swift-in#credit` * Profile level subscriptions: Supported * Application level subscriptions: Supported Events may not be delivered in the order they occurred. Use `data.occurred_at` to reconcile the order. See the [Event ordering guide](/guides/developer/webhooks/event-ordering) for details. See the [Webhooks guide](/guides/developer/webhooks) for setup instructions, signature verification, and best practices. ## Headers - `X-Signature-SHA256` string - `X-Delivery-Id` string, uuid - `X-Test-Notification` boolean ## Payload - union - V420 - `schema_version` '4.2.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook). - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event. - `event_type` string — Event type identifier - `sent_at` string, date-time — Timestamp when the event was sent. - `data` object - `action` object, required - `type` string, required — Type of action. Always `credit`. - `id` integer, required — TransferID of the credit. - `profile_id` integer, required — ProfileID for the transfer. - `account_id` integer, required — AccountID for the transfer. - `resource` object, required - `id` string, required — ID of the webhook. - `uetr` string, guid, required — Unique identifier created by the scheme for each payment and passed through the scheme to Wise. - `reference` string — Reference provided by the ultimate sender for the payment. - `recipient` object - `name` string — Name of the ultimate recipient. - `address` object — Structured address of the ultimate recipient. - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Recipient bank details. - `bic` string — Recipient bank BIC. - `name` string — Recipient bank name. - `address` object — Recipient bank address (same structure as `recipient.address`). - … - `sender` object - `name` string — Name of the ultimate sender. - `address` object — Structured address of the ultimate sender. - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Sender bank details. - `bic` string — Sender bank BIC. - `name` string — Sender bank name. - `address` object — Sender bank address (same structure as `recipient.address`). - … - `exchange_rate` number, double, required — In case the originally instructed amount was converted by Wise or any other intermediary agent, this field contains the exchange rate used. If no conversion took place, the exchange rate will be `1.0`. - `instructed_amount` object — Amount originally instructed by the ultimate sender. - `value` number, double, required — Value of the amount originally instructed by the ultimate sender. - `currency` string, required — Currency of the amount originally instructed by the ultimate sender. 3-letter ISO currency code. - `settled_amount` object, required - `value` number, double, required — Value of the amount settled to the balance account. - `currency` string, required — Currency of the amount settled to the balance account. 3-letter ISO currency code. - `fee` object - `wise` object[] — List of fees applied by Wise (for example, conversion fees). If this list is empty, no fees were applied by Wise. - `type` string, required — Type of fee. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `correspondent` object[] — List of fees declared by correspondents (for example, handling fees). If this list is empty, no fees were declared by correspondents. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `transaction_time` string, date-time, required — Date and time at which the associated transaction was created. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - `previous_instructing_agents` object[] — List of previous instructing agents in the payment chain, ordered from first to last. - `bic` string — Previous instructing agent BIC. - `name` string — Previous instructing agent bank name. - `address` object — Previous instructing agent bank address (same structure as `recipient.address`). - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `incoming_transfer_type` 'CUSTOMER_CREDIT_TRANSFER' | 'FINANCIAL_INSTITUTION_CREDIT_TRANSFER', required — Type of incoming SWIFT credit transfer. `CUSTOMER_CREDIT_TRANSFER` identifies a pacs.008 customer credit transfer. `FINANCIAL_INSTITUTION_CREDIT_TRANSFER` identifies a pacs.009 financial institution credit transfer. The recipient or sender may be a financial institution rather than a customer, so account number may not be present. - `occurred_at` string, date-time, required — Date and time at which the amount was credited to the balance account. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - V410 - `schema_version` '4.1.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook). - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event. - `event_type` string — Event type identifier - `sent_at` string, date-time — Timestamp when the event was sent. - `data` object - `action` object, required - `type` string, required — Type of action. Always `credit`. - `id` integer, required — TransferID of the credit. - `profile_id` integer, required — ProfileID for the transfer. - `account_id` integer, required — AccountID for the transfer. - `resource` object, required - `id` string, required — ID of the webhook. - `uetr` string, guid, required — Unique identifier created by the scheme for each payment and passed through the scheme to Wise. - `reference` string — Reference provided by the ultimate sender for the payment. - `recipient` object - `name` string — Name of the ultimate recipient. - `address` object — Structured address of the ultimate recipient. - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Recipient bank details. - `bic` string — Recipient bank BIC. - `name` string — Recipient bank name. - `address` object — Recipient bank address (same structure as `recipient.address`). - … - `sender` object - `name` string — Name of the ultimate sender. - `address` object — Structured address of the ultimate sender. - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Sender bank details. - `bic` string — Sender bank BIC. - `name` string — Sender bank name. - `address` object — Sender bank address (same structure as `recipient.address`). - … - `exchange_rate` number, double, required — In case the originally instructed amount was converted by Wise or any other intermediary agent, this field contains the exchange rate used. If no conversion took place, the exchange rate will be `1.0`. - `instructed_amount` object — Amount originally instructed by the ultimate sender. - `value` number, double, required — Value of the amount originally instructed by the ultimate sender. - `currency` string, required — Currency of the amount originally instructed by the ultimate sender. 3-letter ISO currency code. - `settled_amount` object, required - `value` number, double, required — Value of the amount settled to the balance account. - `currency` string, required — Currency of the amount settled to the balance account. 3-letter ISO currency code. - `fee` object - `wise` object[] — List of fees applied by Wise (for example, conversion fees). If this list is empty, no fees were applied by Wise. - `type` string, required — Type of fee. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `correspondent` object[] — List of fees declared by correspondents (for example, handling fees). If this list is empty, no fees were declared by correspondents. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `transaction_time` string, date-time, required — Date and time at which the associated transaction was created. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - `previous_instructing_agents` object[] — List of previous instructing agents in the payment chain, ordered from first to last. - `bic` string — Previous instructing agent BIC. - `name` string — Previous instructing agent bank name. - `address` object — Previous instructing agent bank address (same structure as `recipient.address`). - `first_line` string — Address lines concatenated into a single line. Use `address_lines` instead. - `address_lines` string[] — Unstructured address lines - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `occurred_at` string, date-time, required — Date and time at which the amount was credited to the balance account. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - V40024 - `schema_version` '4.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook). - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event. - `event_type` string — Event type identifier - `sent_at` string, date-time — Timestamp when the event was sent. - `data` object - `action` object, required - `type` string, required — Type of action. Always `credit`. - `id` integer, required — TransferID of the credit. - `profile_id` integer, required — ProfileID for the transfer. - `account_id` integer, required — AccountID for the transfer. - `resource` object, required - `id` string, required — ID of the webhook. - `uetr` string, guid, required — Unique identifier created by the scheme for each payment and passed through the scheme to Wise. - `reference` string — Reference provided by the ultimate sender for the payment. - `recipient` object - `name` string — Name of the ultimate recipient. - `address` object — Structured address of the ultimate recipient. - `first_line` string — Address first line. - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Recipient bank details. - `bic` string — Recipient bank BIC. - `name` string — Recipient bank name. - `address` object — Recipient bank address (same structure as `recipient.address`). - … - `sender` object - `name` string — Name of the ultimate sender. - `address` object — Structured address of the ultimate sender. - `first_line` string — Address first line. - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Sender bank details. - `bic` string — Sender bank BIC. - `name` string — Sender bank name. - `address` object — Sender bank address (same structure as `recipient.address`). - … - `exchange_rate` number, double, required — In case the originally instructed amount was converted by Wise or any other intermediary agent, this field contains the exchange rate used. If no conversion took place, the exchange rate will be `1.0`. - `instructed_amount` object — Amount originally instructed by the ultimate sender. - `value` number, double, required — Value of the amount originally instructed by the ultimate sender. - `currency` string, required — Currency of the amount originally instructed by the ultimate sender. 3-letter ISO currency code. - `settled_amount` object, required - `value` number, double, required — Value of the amount settled to the balance account. - `currency` string, required — Currency of the amount settled to the balance account. 3-letter ISO currency code. - `fee` object - `wise` object[] — List of fees applied by Wise (for example, conversion fees). If this list is empty, no fees were applied by Wise. - `type` string, required — Type of fee. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `correspondent` object[] — List of fees declared by correspondents (for example, handling fees). If this list is empty, no fees were declared by correspondents. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `transaction_time` string, date-time, required — Date and time at which the associated transaction was created. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - `previous_instructing_agents` object[] — List of previous instructing agents in the payment chain, ordered from first to last. - `bic` string — Previous instructing agent BIC. - `name` string — Previous instructing agent bank name. - `address` object — Previous instructing agent bank address (same structure as `recipient.address`). - `first_line` string — Address first line. - `street_name` string — Street name. - `building_number` string — Building number. - `town_name` string — Town (city) name. - `postal_code` string — Postal code. - `country_sub_division` string — Country subdivision such as a state, province, or region. - `country_code` string — Country code. 2-letter ISO country code. - `occurred_at` string, date-time, required — Date and time at which the amount was credited to the balance account. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`.`mmm`Z - V3002 - `schema_version` '3.0.0' — Version of the event schema. Determined by the `schema_version` on your [webhook subscription](/api-reference/webhook). - `subscription_id` string, uuid — ID of the webhook subscription that triggered this event - `event_type` string — Event type identifier - `sent_at` string, date-time — Timestamp when the event was sent - `data` object - `action` object, required - `type` string, required — Type of action. Always `credit`. - `id` integer, required — TransferID of the credit. - `profile_id` integer, required — ProfileID for the transfer. - `account_id` integer, required — AccountID for the transfer. - `resource` object, required - `id` string, required — ID of the webhook. - `uetr` string, guid, required — Unique identifier created by the scheme for each payment and passed through the scheme to Wise. - `reference` string — Reference provided by the ultimate sender for the payment. - `recipient` object - `name` string — Name of the ultimate recipient. - `address` string — Address of the ultimate recipient. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Recipient bank details. - `bic` string — Recipient bank BIC. - `name` string — Recipient bank name. - `address` string — Recipient bank address. - `sender` object - `name` string — Name of the ultimate sender. - `address` string — Address of the ultimate sender. - `account` string — This can be either an IBAN, BBAN, AccountId or a Descriptor (another kind of identifier). - `bank_details` object — Sender bank details. - `bic` string — Sender bank BIC. - `name` string — Sender bank name. - `address` string — Sender bank address. - `bank_code` object — Ultimate sender's bank code. - `value` string — Value of the ultimate sender's bank code. This can be either a BIC code, bank institution name, clearing system member code or LEI. - `type` string — Type of the ultimate sender's bank code. This can be either `BIC`, `BANK_CODE` or `BANK_NAME`. - `exchange_rate` number, double, required — In case the originally instructed amount was converted by Wise or any other intermediary agent, this field contains the exchange rate used. If no conversion took place, the exchange rate will be `1.0`. - `instructed_amount` object — Amount originally instructed by the ultimate sender. - `value` number, double, required — Value of the amount originally instructed by the ultimate sender. - `currency` string, required — Currency of the amount originally instructed by the ultimate sender. 3-letter ISO currency code. - `settled_amount` object, required - `value` number, double, required — Value of the amount settled to the balance account. - `currency` string, required — Currency of the amount settled to the balance account. 3-letter ISO currency code. - `fee` object - `wise` object[] — List of fees applied by Wise (e.g., conversion fee). If this list is empty, no fees were applied by Wise. - `type` string, required — Type of fee. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `correspondent` object[] — List of fees declared by correspondents (e.g., handling fee). If this list is empty, no fees were declared by correspondents. - `value` number, double, required — Value of fee. - `currency` string, required — Currency of fee. 3-letter ISO currency code. - `transaction_time` string, date-time, required — Date and time at which the associated transaction was created. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`Z - `occurred_at` string, date-time, required — Date and time at which the amount was credited to the balance account. Time in UTC. Format: `YYYY`-`MM`-`DD`T`HH`:`MM`:`SS`Z ## Acknowledgement `200` Return any `2xx` status to acknowledge receipt of the event. - object - `status` string --- [API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/revisions/4907a1d269ab/schema)