{"id":890,"date":"2025-06-08T11:03:37","date_gmt":"2025-06-08T11:03:37","guid":{"rendered":"https:\/\/lddpay.com\/?post_type=docs&#038;p=890"},"modified":"2025-06-08T11:03:37","modified_gmt":"2025-06-08T11:03:37","password":"","slug":"hosted-payments-page","status":"publish","type":"docs","link":"https:\/\/lddpay.com\/zh\/docs\/hosted-payments-page\/","title":{"rendered":"Hosted Payments Page"},"content":{"rendered":"<h2 class=\"wp-block-heading\">Create a Hosted Payments Page session<\/h2>\n\n\n\n<p>Create a Hosted Payments Page session and pass through all the payment information, like the amount, currency, country and reference.<\/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>Authorizationrequired<\/td><td>stringBearer token (API Key).<\/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 creating a Hosted Payments Page session.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>currencyrequired<\/td><td>string = 3 characters The three-letter ISO currency code of the payment.<\/td><\/tr><tr><td>billingrequired<\/td><td>objectThe billing details.<\/td><\/tr><tr><td>success_urlrequired<\/td><td>string &lt;= 255 characters Overrides the default success redirect URL for redirect payment methods.<\/td><\/tr><tr><td>cancel_urlrequired<\/td><td>string &lt;= 255 characters The URL to which the customer should be directed if they cancel the payment.<\/td><\/tr><tr><td>failure_urlrequired<\/td><td>string &lt;= 255 characters Overrides the default failure redirect URL for redirect payment methods.<\/td><\/tr><tr><td>amount<\/td><td>number &gt;= 0 The payment amount. The exact format depends on the currency.<\/td><\/tr><tr><td>payment_type<\/td><td>string Default: &#8220;Regular&#8221; Enum:&#8221;Regular&#8221;&#8221;Recurring&#8221;This must be specified for card payments where the cardholder is not present.<\/td><\/tr><tr><td>payment_ip<\/td><td>string &lt;= 45 characters The customer&#8217;s IP address. Only IPv4 and IPv6 addresses are accepted.<\/td><\/tr><tr><td>billing_descriptor<\/td><td>objectAn optional description that is displayed on the customer&#8217;s statement identifying a purchase.<\/td><\/tr><tr><td>reference<\/td><td>string &lt;= 50 characters A reference you can use to identify the payment (max 50 chars, Amex: 30, iDEAL: 35, Benefit: unique alphanumeric).<\/td><\/tr><tr><td>description<\/td><td>string &lt;= 100 characters A description of the payment (max 100 chars).<\/td><\/tr><tr><td>display_name<\/td><td>stringThe merchant name to display to customers on the checkout page.<\/td><\/tr><tr><td>processing_channel_id<\/td><td>string^(pc)_(\\w{26})$The processing channel to be used for the payment.<\/td><\/tr><tr><td>amount_allocations<\/td><td>Array of objectsThe sub-entities that the payment is being processed on behalf of.<\/td><\/tr><tr><td>customer<\/td><td>objectThe customer&#8217;s details.<\/td><\/tr><tr><td>shipping<\/td><td>objectThe address any products are being sent to.<\/td><\/tr><tr><td>recipient<\/td><td>objectInformation about the recipient of the payment&#8217;s funds.<\/td><\/tr><tr><td>processing<\/td><td>objectUse the processing object to influence or override the data sent during card processing.<\/td><\/tr><tr><td>allow_payment_methods<\/td><td>Array of stringsSpecifies which payment method options to present to the customer.<\/td><\/tr><tr><td>disabled_payment_methods<\/td><td>Array of stringsSpecifies which payment method options to not present to the customer.<\/td><\/tr><tr><td>products<\/td><td>Array of objectsContains details about the products in the order.<\/td><\/tr><tr><td>risk<\/td><td>objectConfigures the risk assessment performed during payment processing.<\/td><\/tr><tr><td>customer_retry<\/td><td>objectConfigures the parameters for customer retries.<\/td><\/tr><tr><td>sender<\/td><td>objectThe sender of the payment.<\/td><\/tr><tr><td>metadata<\/td><td>objectAllows you to store additional information about the transaction. Only one level of depth is allowed.<\/td><\/tr><tr><td>locale<\/td><td>string Default: &#8220;en-GB&#8221;Creates a translated version of the page in the specified language.<\/td><\/tr><tr><td>3ds<\/td><td>objectInformation required for 3D Secure payments.<\/td><\/tr><tr><td>capture<\/td><td>booleanWhether to capture the payment (if applicable).<\/td><\/tr><tr><td>capture_on<\/td><td>stringA timestamp (ISO 8601 code) that determines when the payment should be captured. Providing this field will automatically set capture to true.<\/td><\/tr><tr><td>instruction<\/td><td>objectDetails about the payment instruction.<\/td><\/tr><tr><td>payment_method_configuration<\/td><td>objectConfiguration options for specific payment methods.<\/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 Created Hosted Payments Page<\/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 unique identifier for a Hosted Payments Page.<\/td><\/tr><tr><td>_linksrequired<\/td><td>objectThe links related to the hosted payment.<\/td><\/tr><tr><td>referencerequired<\/td><td>stringA reference you can later use to identify this payment, such as an order number.<\/td><\/tr><tr><td>warnings<\/td><td>Array of objectsWarnings related to the allow_payment_methods object in the request.<\/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\/Hosted-Payments-Page\/operation\/HostedPaymentsController_getHostedPaymentsDetails\"><\/a><\/h2>\n\n\n\n<h2 class=\"wp-block-heading\">Get Hosted Payments Page details<\/h2>\n\n\n\n<p>Retrieve details about a specific Hosted Payments Page using the ID returned when it was created. In the response, you will see the status of the Hosted Payments Page.<\/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>idrequired<\/td><td>string = 16 characters ^hpp_[A-Za-z0-9_-]{12}$The unique identifier for a Hosted Payments Page.<\/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 Hosted Payments Page details retrieved successfully<\/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 unique identifier for a Hosted Payments Page.<\/td><\/tr><tr><td>statusrequired<\/td><td>string Enum:&#8221;Payment Pending&#8221;&#8221;Payment Received&#8221;&#8221;Expired&#8221;The status of the Hosted Payments Page.<\/td><\/tr><tr><td>amountrequired<\/td><td>numberThe original payment amount.<\/td><\/tr><tr><td>currencyrequired<\/td><td>stringThe three-letter ISO currency code of the payment.<\/td><\/tr><tr><td>billingrequired<\/td><td>objectThe billing details.<\/td><\/tr><tr><td>success_urlrequired<\/td><td>stringThe provided URL your customer will be redirected to upon a successful payment.<\/td><\/tr><tr><td>cancel_urlrequired<\/td><td>stringThe provided URL your customer will be redirected to if the payment is cancelled.<\/td><\/tr><tr><td>failure_urlrequired<\/td><td>stringThe provided URL your customer will be redirected to upon a failed payment.<\/td><\/tr><tr><td>_linksrequired<\/td><td>objectThe links related to the Hosted Payments Page.<\/td><\/tr><tr><td>payment_id<\/td><td>stringUnique identifier for an in progress or completed payment for this Payment Link.<\/td><\/tr><tr><td>reference<\/td><td>stringYour reference for the payment.<\/td><\/tr><tr><td>description<\/td><td>stringA description of the payment.<\/td><\/tr><tr><td>customer<\/td><td>objectThe customer&#8217;s details.<\/td><\/tr><tr><td>products<\/td><td>Array of objectsContains details about the products in the order.<\/td><\/tr><tr><td>metadata<\/td><td>objectAny additional information stored at the point of creation.<\/td><\/tr><tr><td>amount_allocations<\/td><td>Array of objectsThe sub-entities that the payment is being processed on behalf of.<\/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 Hosted Payments Page 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_id required<\/td><td>stringThe unique request identifier.<\/td><\/tr><tr><td>error_type required<\/td><td>stringThe error type.<\/td><\/tr><tr><td>error_codes required<\/td><td>Array of stringsThe error codes.<\/td><\/tr><\/tbody><\/table><\/figure>\n<\/details>","protected":false},"excerpt":{"rendered":"<p>Create a Hosted Payments Page session Create a Hosted Payments Page session and pass through all the payment information, like [&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":744,"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\/890"}],"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=890"}],"version-history":[{"count":1,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/890\/revisions"}],"predecessor-version":[{"id":891,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/docs\/890\/revisions\/891"}],"wp:attachment":[{"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/media?parent=890"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_category?post=890"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/lddpay.com\/zh\/wp-json\/wp\/v2\/doc_tag?post=890"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}