{"templateId":"markdown","versions":[{"version":"v2026.03","label":"v2026.03","link":"/products/payments-direct-2/api-docs/integration-resources/apac/cn/cny","default":true,"active":true,"folderId":"eb16255d"},{"version":"v2025.11","label":"v2025.11","link":"/products/payments-direct-2/v2025.11/api-docs/integration-resources/apac/cn/cny","default":false,"active":false,"folderId":"eb16255d"}],"sharedDataIds":{"sidebar":"sidebar-products/payments-direct-2/@v2025.11/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"China (CNY) Transaction Data Requirements","description":"User guides, API reference, and support resources.","siteUrl":"https://docs.ripple.com/products/custody","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"china-cny-transaction-data-requirements","__idx":0},"children":["China (CNY) Transaction Data Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following transaction-level fields apply to all CNY payments to China via CNAPS (China National Advanced Payment System)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a list of supported bank codes required to route payments to Chinese financial institutions, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments-direct-2/api-docs/integration-resources/apac/cn/china-bank-codes"},"children":["China bank codes"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"15%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"20%","data-label":"Description"},"children":["Description "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"Constraints"},"children":["Constraints "]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purposeCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purpose of payment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ENUM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#purpose-of-payment-codes"},"children":["valid values"]}," below"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Invoice document requirement (UI only)"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CNY payments made through the Ripple Payments Direct UI require an invoice document to be uploaded before the payment can be submitted. This requirement applies to UI customers only and is not part of the API payment request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"purpose-of-payment-codes","__idx":1},"children":["Purpose of payment codes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAMI"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Family support"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GDDS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purchase or sale of goods"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Salary payment"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SCVE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Purchase or sale of services"]}]}]}]}]}]},"headings":[{"value":"China (CNY) Transaction Data Requirements","id":"china-cny-transaction-data-requirements","depth":1},{"value":"Purpose of payment codes","id":"purpose-of-payment-codes","depth":2}],"frontmatter":{"title":"China — CNY Transaction Data Requirements","description":"Transaction-level field requirements and valid values for CNY payments to China.","seo":{"title":"China (CNY) Transaction Data Requirements"}},"lastModified":"2026-04-03T15:45:06.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/payments-direct-2/api-docs/integration-resources/apac/cn/cny","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}