> This page is for Enterprise. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://citi-demo.ferndocs.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://citi-demo.ferndocs.com/_mcp/server. # Post Txrefund POST https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund Content-Type: application/xml Reference: https://citi-demo.ferndocs.com/enterprises/api-reference/payment-services/payments/payment-refund/post-txrefund ## Authentication - `Authorization` header (bearer token, required) — All CitiConnect APIs use the oAuth2 authentication scheme, which requires a bearer token to authenticate your API call. The Token URL includes the version of authentication used by this API. See the Citi Authentication API Reference for information on requesting a token. ## Servers - `https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3` (production gateway URL, default) - `https://tts.apib2b.citi.com/citiconnect/sb/paymentservices/v3` (sandbox URL) - `//$(catalog.host)` (//$(catalog.host)) ## Request ### Body (application/xml) This endpoint expects an any. - `any` ## Response ### 200 200 OK ## Errors ### 400 Bad Request Error Bad Request - `any` ### 401 Unauthorized Error Unauthorized; OAuth header decryption failed - `any` ### 405 Method Not Allowed Error Method Not Allowed - `any` ### 412 Precondition Failed Error Precondition Failed - `any` ### 415 Unsupported Media Type Error Unsupported Media Type - `any` ### 429 Too Many Requests Error Too Many Requests - `any` ### 500 Internal Server Error Internal Server Error - `any` ### 503 Service Unavailable Error Service Unavailable - `any` ### 504 Gateway Timeout Error Gateway Timeout - `any` ## Examples **Request** ```json "CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678" ``` **Response** ```json "CITIBANK/20191211-PSR/9414161772019-12-11T06:24:52CITIUS33MsgIdffghpain.007.001.092019-12-11T12:00:001456879620191209CITISGS0BRT2101630ACTC" ``` **SDK Code** ```python import requests url = "https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund" payload = "\"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678\"" headers = { "Authorization": "Bearer ", "Content-Type": "application/xml" } response = requests.post(url, data=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/xml'}, body: '"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678"' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund" payload := strings.NewReader("\"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678\"") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/xml") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/xml' request.body = "\"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678\"" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund") .header("Authorization", "Bearer ") .header("Content-Type", "application/xml") .body("\"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678\"") .asString(); ``` ```php request('POST', 'https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund', [ 'body' => '"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678"', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/xml', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/xml"); request.AddParameter("application/xml", "\"CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678\"", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/xml" ] let postData = NSData(data: ""CITIBANK/20200617-PSR/17272375002020-06-17T07:27:08CITIUS33GBP161114694869pain.001.001.032017-06-02T10:17:5511PDNG14017498 Fund Transfer DomesticPA2018201912PDNGPayment validation is in-progress1.002019-08-20URGPTRFCITIBANK E-BUSINESS EUR DUM DEMO12345678fakebicGBfakebic8010643122X XXXXXXXXXXXXX XXXWDW 3 INVESTMENTS LIMITED12345678"".data(using: String.Encoding.utf8)!) let request = NSMutableURLRequest(url: NSURL(string: "https://tts.apib2b.citi.com/citiconnect/prod/paymentservices/v3/txrefund")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```