{"id":892,"date":"2025-06-08T11:07:21","date_gmt":"2025-06-08T11:07:21","guid":{"rendered":"https:\/\/lddpay.com\/?post_type=docs&p=892"},"modified":"2025-06-08T11:07:21","modified_gmt":"2025-06-08T11:07:21","password":"","slug":"forex","status":"publish","type":"docs","link":"https:\/\/lddpay.com\/zh\/docs\/forex\/","title":{"rendered":"Forex"},"content":{"rendered":"

<\/a>Get FX rates<\/h2>\n\n\n\n

Use the Forex (FX) rates API to get the indicative foreign exchange rates that Payfac uses to process payments for card payouts or scheme acquiring. You can query the rates and the related source of rates (for example, Visa, Mastercard).<\/p>\n\n\n\n

Authorizations<\/summary>\n

bearer<\/em><\/p>\n\n\n\n

<\/h5>\n\n\n\n
HTTP: bearer<\/h5>\n\n\n\n

HTTP Authorization Scheme: <\/strong>bearer<\/code><\/p>\n\n\n\n

Bearer format: <\/strong>JWT<\/code><\/p>\n<\/details>\n\n\n\n

query Parameters<\/h5>\n\n\n\n
product required<\/td>string Enum:”card_payouts””scheme_acquiring”The Payfac Forex product to return rates for.<\/td><\/tr>
sourcer equired<\/td>string Enum:”visa””mastercard”The source of provided rates.<\/td><\/tr>
currency_pairs required<\/td>string Example: currency_pairs=GBPEUR,USDNOK,JPNCADComma-separated list of currency pairs.<\/td><\/tr>
processing_channel_idr equired<\/td>string^(pc)_(\\w{26})$ Example: processing_channel_id=pc_vxt6yftthv4e5flqak6w2i7rimThe processing channel identifier.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
header Parameters<\/h5>\n\n\n\n
Authorization required<\/td>string<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Responses<\/h5>\n\n\n\n
200 Rates retrieved successfully<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
productrequired<\/td>string Enum:”card_payouts””scheme_acquiring”The Checkout.com Forex product.<\/td><\/tr>
sourcerequired<\/td>string Enum:”visa””mastercard”The source of provided rates.<\/td><\/tr>
<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
required<\/td>Array of objects (ForexRateDto) List of FX rates with Checkout.com margin applied.<\/td><\/tr>
invalid_currency_pairs<\/td>Array of stringsList of currency pairs that Checkout.com was unable to provide rates for.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n

401 Unauthorized<\/p>\n\n\n\n

403 Forbidden. The client is not enabled for the requested product<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
request_idrequired<\/td>stringThe unique request identifier.<\/td><\/tr>
error_typerequired<\/td>stringThe error type.<\/td><\/tr>
error_codesrequired<\/td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n
422 Invalid data was sent<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
request_idrequired<\/td>stringThe unique request identifier.<\/td><\/tr>
error_typerequired<\/td>stringThe error type.<\/td><\/tr>
error_codesrequired<\/td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n
429 Too many requests or duplicate requests detected<\/summary>\n
Response Schema: application\/json<\/h5>\n\n\n\n
request_idrequired<\/td>stringThe unique request identifier.<\/td><\/tr>
error_typerequired<\/td>stringThe error type.<\/td><\/tr>
error_codesrequired<\/td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n

502 Bad gateway<\/p>","protected":false},"excerpt":{"rendered":"

Get FX rates Use the Forex (FX) rates API to get the indicative foreign exchange rates that Payfac uses to […]<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"doc_category":[122],"doc_tag":[],"year_month":"2026-04","word_count":258,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"author_nicename":"admin","author_url":"https:\/\/lddpay.com\/zh\/author\/admin\/"},"doc_category_info":[{"term_name":"Temp Solution","term_url":"https:\/\/lddpay.com\/zh\/docs-category\/temp-solution\/"}],"doc_tag_info":[],"author_list":[{"ID":"3","user_login":"jony","display_name":"jony","id":"3"},{"ID":"2","user_login":"Merchantlogin","display_name":"Merchantlogin","id":"2"},{"ID":"1","user_login":"w2863431","display_name":"admin","id":"1"}],"_links":{"self":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/892"}],"collection":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/comments?post=892"}],"version-history":[{"count":1,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/892\/revisions"}],"predecessor-version":[{"id":893,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/892\/revisions\/893"}],"wp:attachment":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/media?parent=892"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_category?post=892"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_tag?post=892"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}