{"id":896,"date":"2025-06-08T11:18:16","date_gmt":"2025-06-08T11:18:16","guid":{"rendered":"https:\/\/lddpay.com\/?post_type=docs&#038;p=896"},"modified":"2025-06-08T11:18:16","modified_gmt":"2025-06-08T11:18:16","password":"","slug":"transfers","status":"publish","type":"docs","link":"https:\/\/lddpay.com\/zh\/docs\/transfers\/","title":{"rendered":"Transfers"},"content":{"rendered":"<h2 class=\"wp-block-heading\"><a href=\"file:\/\/\/C:\/Users\/Administrator\/Downloads\/payfac-doc (1).htm#tag\/Transfers\/operation\/TransfersController_createTransfer\"><\/a>Initiate a transfer of funds<\/h2>\n\n\n\n<p>Initiate a transfer of funds from source entity to destination entity.<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>Authorizations<\/summary>\n<p><em>bearer<\/em><\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><\/h5>\n\n\n\n<h5 class=\"wp-block-heading\">HTTP: bearer<\/h5>\n\n\n\n<p><strong>HTTP Authorization Scheme: <\/strong><code>bearer<\/code><\/p>\n\n\n\n<p><strong>Bearer format: <\/strong><code>JWT<\/code><\/p>\n<\/details>\n\n\n\n<h5 class=\"wp-block-heading\">header Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Authorization required<\/td><td>stringBearer token (API Key or OAuth2 Access Token).<\/td><\/tr><tr><td>Cko-Idempotency-Key required<\/td><td>stringAn idempotency key for safely retrying transfer requests.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Request Body schema: application\/json<\/h5>\n\n\n\n<p>Request body for initiating a transfer of funds.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>transfer_type required<\/td><td>string Enum:&#8221;commission&#8221;&#8221;promotion&#8221;&#8221;refund&#8221;The type of transfer.<\/td><\/tr><tr><td>source required<\/td><td>objectThe object representing the source of the funds involved in the transfer.<\/td><\/tr><tr><td>destination required<\/td><td>objectThe object representing the destination of the funds involved in the transfer.<\/td><\/tr><tr><td>reference<\/td><td>string &lt;= 50 characters A reference you can use later to identify this transfer (max 50 chars).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Responses<\/h5>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>201 Transfer successfully created.<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>id required<\/td><td>stringThe id representing the initiated transfer.<\/td><\/tr><tr><td>status required<\/td><td>string Enum:&#8221;pending&#8221;&#8221;completed&#8221;&#8221;rejected&#8221;The current state of the initiated transfer.<\/td><\/tr><tr><td>_links required<\/td><td>objectLinks related to the transfer.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>400 Bad Request<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_idrequired<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_typerequired<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codesrequired<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<p>401 Unauthorized<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>422 Invalid data was sent.<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_idrequired<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_typerequired<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codesrequired<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"file:\/\/\/C:\/Users\/Administrator\/Downloads\/payfac-doc (1).htm#tag\/Transfers\/operation\/TransfersController_getTransfer\"><\/a><\/h2>\n\n\n\n<h2 class=\"wp-block-heading\">Retrieve a transfer<\/h2>\n\n\n\n<p>Retrieve transfer details using the transfer identifier.<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>Authorizations<\/summary>\n<p><em>bearer<\/em><\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><\/h5>\n\n\n\n<h5 class=\"wp-block-heading\">HTTP: bearer<\/h5>\n\n\n\n<p><strong>HTTP Authorization Scheme: <\/strong><code>bearer<\/code><\/p>\n\n\n\n<p><strong>Bearer format: <\/strong><code>JWT<\/code><\/p>\n<\/details>\n\n\n\n<h5 class=\"wp-block-heading\">path Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>idr equired<\/td><td>string Example: tra_y3oqhf46pyzuxjbcn2giaqnb4The transfer identifier.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">header Parameters<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Authorization required<\/td><td>string<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Responses<\/h5>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>200 Transfer found<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>idrequired<\/td><td>stringThe transfer identifier.<\/td><\/tr><tr><td>referencerequired<\/td><td>stringA unique reference used to identify this transfer.<\/td><\/tr><tr><td>statusrequired<\/td><td>string Enum:&#8221;pending&#8221;&#8221;completed&#8221;&#8221;rejected&#8221;The current state of the initiated transfer.<\/td><\/tr><tr><td>transfer_typerequired<\/td><td>string Enum:&#8221;commission&#8221;&#8221;promotion&#8221;&#8221;refund&#8221;The type of transfer.<\/td><\/tr><tr><td>requested_onrequired<\/td><td>stringThe date the transfer was requested on.<\/td><\/tr><tr><td>reason_codes<\/td><td>Array of stringsAn optional set of reason codes describing why the transfer is in its current state.<\/td><\/tr><tr><td>sourcerequired<\/td><td>objectThe source of the funds involved in the transfer.<\/td><\/tr><tr><td>destinationrequired<\/td><td>objectThe destination of the funds involved in the transfer.<\/td><\/tr><tr><td>_linksrequired<\/td><td>objectLinks related to the transfer.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>400 Bad Request<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_idrequired<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_typerequired<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codesrequired<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<p>401 Unauthorized<\/p>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>404 Transfer not found<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_idrequired<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_typerequired<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codesrequired<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>\n\n\n\n<details class=\"wp-block-details is-layout-flow wp-block-details-is-layout-flow\"><summary>422 Invalid data was sent<\/summary>\n<h5 class=\"wp-block-heading\">Response Schema: application\/json<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>request_idrequired<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_typerequired<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codesrequired<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>","protected":false},"excerpt":{"rendered":"<p>Initiate a transfer of funds Initiate a transfer of funds from source entity to destination entity. header Parameters Authorization required [&hellip;]<\/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":385,"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\/896"}],"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=896"}],"version-history":[{"count":1,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/896\/revisions"}],"predecessor-version":[{"id":897,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/896\/revisions\/897"}],"wp:attachment":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/media?parent=896"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_category?post=896"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_tag?post=896"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}