---
title: "external_payment.created"
method: POST
path: "external_payment.created"
tags: ["Event Types"]
---

# external_payment.created

`POST external_payment.created` (webhook)

Occurs when an external payment is created.

## Payload

- object — Base class for all transaction types in the ledger service
  - `event_type` 'external_payment.created', required — The type of event that occurred.
  - `status` 'PENDING' | 'SETTLED' | 'DECLINED' | 'REVERSED' | 'CANCELED' | 'RETURNED', required
  - `token` string, uuid, required — Unique identifier for the transaction
  - `created` string, date-time, required — ISO 8601 timestamp of when the transaction was created
  - `updated` string, date-time, required — ISO 8601 timestamp of when the transaction was last updated
  - `family` 'EXTERNAL_PAYMENT', required — EXTERNAL_PAYMENT - External Payment Response
  - `result` 'APPROVED' | 'DECLINED', required
  - `category` 'EXTERNAL_WIRE' | 'EXTERNAL_ACH' | 'EXTERNAL_CHECK' | 'EXTERNAL_FEDNOW' | 'EXTERNAL_RTP' | 'EXTERNAL_TRANSFER', required
  - `settled_amount` integer, required
  - `pending_amount` integer, required
  - `currency` string, required
  - `events` ExternalPaymentEvent[], required
    - `amount` integer, required
    - `type` 'EXTERNAL_WIRE_INITIATED' | 'EXTERNAL_WIRE_CANCELED' | 'EXTERNAL_WIRE_SETTLED' | 'EXTERNAL_WIRE_REVERSED' | 'EXTERNAL_WIRE_RELEASED' | 'EXTERNAL_ACH_INITIATED' | 'EXTERNAL_ACH_CANCELED' | 'EXTERNAL_ACH_SETTLED' | 'EXTERNAL_ACH_REVERSED' | 'EXTERNAL_ACH_RELEASED' | 'EXTERNAL_TRANSFER_INITIATED' | 'EXTERNAL_TRANSFER_CANCELED' | 'EXTERNAL_TRANSFER_SETTLED' | 'EXTERNAL_TRANSFER_REVERSED' | 'EXTERNAL_TRANSFER_RELEASED' | 'EXTERNAL_CHECK_INITIATED' | 'EXTERNAL_CHECK_CANCELED' | 'EXTERNAL_CHECK_SETTLED' | 'EXTERNAL_CHECK_REVERSED' | 'EXTERNAL_CHECK_RELEASED' | 'EXTERNAL_FEDNOW_INITIATED' | 'EXTERNAL_FEDNOW_CANCELED' | 'EXTERNAL_FEDNOW_SETTLED' | 'EXTERNAL_FEDNOW_REVERSED' | 'EXTERNAL_FEDNOW_RELEASED' | 'EXTERNAL_RTP_INITIATED' | 'EXTERNAL_RTP_CANCELED' | 'EXTERNAL_RTP_SETTLED' | 'EXTERNAL_RTP_REVERSED' | 'EXTERNAL_RTP_RELEASED', required
    - `result` 'APPROVED' | 'DECLINED', required
    - `detailed_results` DetailedResults[], required
    - `created` string, date-time, required
    - `token` string, uuid, required
    - `memo` string, required
    - `effective_date` string, date, required
  - `user_defined_id` string, nullable
  - `financial_account_token` string, uuid, required
  - `payment_type` 'DEPOSIT' | 'WITHDRAWAL', required

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/versions/53ab5d4e2adb/schema)