# Citi Outgoing Payments APIs

**Canonical:** https://apis.io/apis/citi/citi-outgoing-payments-apis/  
**Provider:** Citi — https://apis.io/providers/citi/  
**Base URL:** https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3  
**Documentation:** https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview

Citi Outgoing Payments APIs is one of 12 APIs that [Citi](https://apis.io/providers/citi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Payments, ISO 20022, and Treasury. The published artifact set on APIs.io includes API documentation, an API reference, an OpenAPI specification, and authentication docs.

Payment initiation, status, cancellation, refund, enhanced inquiry, reconfirmation, bulk payments, instant/express payments and WorldLink cross-border payouts. Message bodies are ISO 20022 (pain.001, pain.002, pacs.008, pacs.009, camt.056) in both JSON and XML encodings. Citi publishes 27 machine-readable specifications for this family covering 71 operations, served from developer.citi.com.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/digitalpayments/v1/payment-acceptance/methods` | Payment Method Details |
| POST | `/digitalpayments/v1/payment-acceptance` | Submit A Payment With Selected Payment Method |
| GET | `/digitalpayments/v1/payment-acceptance` | Get Transaction Details |
| POST | `/digitalpayments/v1/payment-acceptance/refunds` | Initiate An Outgoing Instant Refund Credit Transfer |
| GET | `/digitalpayments/v1/payment-acceptance/refunds` | Get refund transaction details |
| PATCH | `/digitalpayments/v1/payment-acceptance/refunds/{id}` | Update a payment with selected payment method. |
| POST | `/digitalpayments/v1/payment-acceptance/tokens` | Create a Tokenization request. |
| GET | `/digitalpayments/v1/payment-acceptance/tokens` | Retrieve token details |
| PATCH | `/digitalpayments/v1/payment-acceptance/tokens` | Token Update Request. |
| DELETE | `/digitalpayments/v1/payment-acceptance/tokens` | Token Delete Request. |
| PATCH | `/digitalpayments/v1/payment-acceptance/{id}` | Update a payment with selected payment method. |
| POST | `/digitalpayments/v1/payment-acceptance/authentication` | Create a authentication request. |
| PATCH | `/digitalpayments/v1/payment-acceptance/authentication/{id}` | Payer Authentication Request. |
| POST | `/digitalpayments/v1/payment-acceptance/mandates` | Initiate New Mandate Outgoing Request |
| GET | `/digitalpayments/v1/payment-acceptance/mandates` | Get Mandate details |
| PATCH | `/digitalpayments/v1/payment-acceptance/mandates` | Cancel Mandate Outgoing Request |
| GET | `/digitalpayments/v1/payment-acceptance/sessions` | Retrieve session details |
| POST | `/digitalpayments/v1/payment-acceptance/sessions` | Create a Session request. |
| PATCH | `/digitalpayments/v1/payment-acceptance/sessions/{id}` | Create a Session request. |

## Machine-readable artifacts (36)

- **Documentation** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
- **APIReference** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-digitalpaymentscollectionsv12-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-express-payments-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-payto-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-vamanagement-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-add-on-service-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-addonservice-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-worldlink-v2-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-worldlink-v3-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-payment-status-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-worldlink-v5-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-bulk-payments-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-contractstatusinquiry-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-payment-reconfirmation-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-payment-refund-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentcancellation-json-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentcancellation-xml-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentenhancedinquiry-json-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentenhancedinquiry-xml-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentinitiation-pacs008-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentinitiation-pacs009-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentinitiation-pain102-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-paymentinitiation-pain103-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-proof-of-payment-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-worldlink-ir-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-worldlink-v1-api-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-digitalpaymentscollections-webhooks-openapi.yaml
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-express-payments-webhooks-openapi.yaml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/overlays/citi-outgoing-payments-overlay.yaml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/authentication/citi-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/conventions/citi-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/errors/citi-problem-types.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/sandbox/citi-sandbox.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/asyncapi/citi-webhooks.yml
- **DeclineCodes** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/errors/citi-decline-codes.yml

## Other Citi APIs (11)

- [Citi API Authentication Services](https://apis.io/apis/citi/citi-api-authentication-services/)
- [Citi Account Reporting APIs](https://apis.io/apis/citi/citi-account-reporting-apis/)
- [Citi Payment Acceptance APIs](https://apis.io/apis/citi/citi-payment-acceptance-apis/)
- [Citi Commercial Cards and Virtual Card Accounts APIs](https://apis.io/apis/citi/citi-commercial-cards-and-virtual-card-accounts-apis/)
- [CitiFX Gateway and Instant FX APIs](https://apis.io/apis/citi/citifx-gateway-and-instant-fx-apis/)
- [Citi Custody and Securities Services APIs](https://apis.io/apis/citi/citi-custody-and-securities-services-apis/)
- [Citi Funds Transfer Agency APIs](https://apis.io/apis/citi/citi-funds-transfer-agency-apis/)
- [Citi Open Banking APIs](https://apis.io/apis/citi/citi-open-banking-apis/)
- [CitiConnect Trade Services APIs](https://apis.io/apis/citi/citiconnect-trade-services-apis/)
- [Citi Gateway Services API](https://apis.io/apis/citi/citi-gateway-services-api/)
- [Citi Additional Payment Services APIs](https://apis.io/apis/citi/citi-additional-payment-services-apis/)

## Tags

Payments, ISO 20022, Treasury

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/citi/citi-outgoing-payments-apis/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/citi/.
