# Citi Payments API

**Canonical:** https://apis.io/apis/citi/citi-payments-api/  
**Provider:** Citi — https://apis.io/providers/citi/  
**Base URL:** https://tts.apib2b.citi.com/citiconnect/prod  
**Documentation:** https://developer.citi.com/apidocs/authentication/authentication-only-guide

Citi Payments API is one of 104 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. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

Use the Payments endpoint to initiate and track instant payments. While all payments can be sent through a single CitiConnect API, it is important to observe local country requirements to avoid rejects and returned transactions. The table below shows the minimum fields required to initiate a Thailand Instant Payment transaction. For a full list of fields please refer to the swagger files shared by your Citi representative. To ensure that a payment is initiated correctly: * Ensure you have the required datapoints to initiate a transaction in the country where your payee is located. * Make a ``POST`` request to the `/paymentservices/v1/payments` endpoint and include the required information inside the payload of the request to initiate the transaction.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/payments/reconfirmations` | Payment Reconfirmation |
| POST | `/payments/stops` | Payment Cancellation |
| POST | `/paymentservices/v1/payments` | Initiate an outgoing instant payment credit transfer |
| GET | `/paymentservices/v1/payments` | Inquire for the latest status of transations matching additional parameters |
| GET | `/paymentservices/v1/payments/{uetr}` | Inquire for the latest status of a transaction using UETR |
| POST | `/payments` | Make a payment |
| GET | `/payments/{payment-Id}` | Get a payment |

## Machine-readable artifacts (31)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/citi/refs/heads/main/openapi/citi-payments-api-openapi.yml
- **Documentation** — https://developer.citi.com/apidocs/authentication/authentication-only-guide
- **APIReference** — https://developer.citi.com/apidocs/authentication/authentication-api-reference
- **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
- **Documentation** — https://developer.citi.com/apidocs/account-reporting/balances/balances-overview
- **APIReference** — https://developer.citi.com/apidocs/account-reporting/balances/balances-api-reference
- **Documentation** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-overview
- **APIReference** — https://developer.citi.com/apidocs/outgoing-payments/payments/payments-api-reference
- **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
- **Documentation** — https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-overview
- **APIReference** — https://developer.citi.com/apidocs/accept-payments/online-payment-acceptance/online-payment-acceptance-api-reference
- **Documentation** — https://developer.citi.com/apidocs/commercial-cards/virtual-cards/commercial-cards-overview
- **APIReference** — https://developer.citi.com/apidocs/commercial-cards/virtual-cards/virtual-cards-api-reference
- **Documentation** — https://developer.citi.com/apidocs/fx/gateway/citifx-gateway-overview
- **APIReference** — https://developer.citi.com/apidocs/fx/instant-fx/instant-fx-overview
- **Documentation** — https://developer.citi.com/apidocs/custody/accounts/accounts-overview
- **APIReference** — https://developer.citi.com/apidocs/custody/safekeeping-positions/safekeeping-positions-api-reference
- **Documentation** — https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-overview
- **APIReference** — https://developer.citi.com/apidocs/transfer-agency/accounts/accounts-api-reference
- **Documentation** — https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-open-banking-overview
- **APIReference** — https://developer.citi.com/apidocs/open-banking/ukraine-open-banking/ukraine-bank-data-sharing-api-reference
- **Documentation** — https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-overview
- **APIReference** — https://developer.citi.com/apidocs/trade/standby-letters-of-credit/trade-api-reference
- **Documentation** — https://developer.citi.com/apidocs/gateway-services/gateway-services-user-guide
- **APIReference** — https://developer.citi.com/apidocs/gateway-services/gateway-services-api-reference
- **Documentation** — https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-overview
- **APIReference** — https://developer.citi.com/apidocs/additional-payment-services/additional-payment-services/additional-payment-services-api-reference

## Other Citi APIs (12)

- [Citi Account Notification API](https://apis.io/apis/citi/citi-account-notification-api/)
- [Citi Accounts API](https://apis.io/apis/citi/citi-accounts-api/)
- [Citi Addonservices API](https://apis.io/apis/citi/citi-addonservices-api/)
- [Citi Authentication API](https://apis.io/apis/citi/citi-authentication-api/)
- [Citi Authenticationservices API](https://apis.io/apis/citi/citi-authenticationservices-api/)
- [Citi Authorization API](https://apis.io/apis/citi/citi-authorization-api/)
- [Citi Balance API](https://apis.io/apis/citi/citi-balance-api/)
- [Citi Bank Data Sharing API](https://apis.io/apis/citi/citi-bankdatasharing-api/)
- [Citi Beneficiary Validation API](https://apis.io/apis/citi/citi-beneficiary-validation-api/)
- [Citi Billing API](https://apis.io/apis/citi/citi-billing-api/)
- [Citi Blocks & Filters API](https://apis.io/apis/citi/citi-blocks-filters-api/)
- [Citi Branch API](https://apis.io/apis/citi/citi-branch-api/)

## Tags

Payments

---

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