# Payments

Payments are used to orchestrate end to end payment flows from external parties or from within the platform. 

## Create Payment

 - [POST /v1/payments](https://docs.rail.io/api-docs/openapi/rail-spec/payments/createpayments.md): Create a payment request for a platform account in order to receive funds from an external third party.

## Accept Payment

 - [POST /v1/payments/{payment_id}/accept](https://docs.rail.io/api-docs/openapi/rail-spec/payments/acceptpayment.md): Accept a Payment. On acceptance, payment instructions will be returned (if source = counterparty) or funds will begin processing (if source = account).

## Retrieve Payment

 - [GET /v1/payments/{payment_id}](https://docs.rail.io/api-docs/openapi/rail-spec/payments/getpayment.md): Retrieves details of a previously requested payment

## Retrieve Payment Status

 - [GET /v1/payments/{payment_id}/status](https://docs.rail.io/api-docs/openapi/rail-spec/payments/getpaymentstatus.md): Retrieves status of a previously created payment. Provides insight into any actions or RFIs that require attention.