{"id":455,"date":"2026-05-29T13:06:58","date_gmt":"2026-05-29T13:06:58","guid":{"rendered":"https:\/\/developers.10npay.com\/docs\/icard-card-initiate\/"},"modified":"2026-05-29T13:13:51","modified_gmt":"2026-05-29T13:13:51","password":"","slug":"icard-card-initiate","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/icard-card-initiate\/","title":{"rendered":"Save Card via iCard (Initiate)"},"content":{"rendered":"<h1>Save Card via iCard (Gateway Initiate)<\/h1>\n<p>Triggers the gateway-proxied iCard flow for registering a reusable payment method. Use it before listing cards with <code>GET \/api\/v1\/IndividualPaymentMethod\/{individualId}<\/code>.<\/p>\n<h2>Endpoint<\/h2>\n<pre><code>POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualPaymentMethod\/{individualId}\/card-initiate\n<\/code><\/pre>\n<h2>Request body<\/h2>\n<pre><code>{\n  \"deviceIP\": \"94.72.159.162\"\n}\n<\/code><\/pre>\n<h2>Response (200)<\/h2>\n<pre><code>{\n  \"data\": \"c76ac88badd96a37d1a7a744b4aecbdcad641d83\",\n  \"redirectUrl\": \"https:\/\/dev-ipg.icards.eu\/sandbox\/\"\n}\n<\/code><\/pre>\n<h2>Embed snippet<\/h2>\n<pre><code>&lt;div id=&quot;ipg&quot;&gt;&lt;\/div&gt;\n&lt;script&gt;\nconst domain = &#039;https:\/\/dev-ipg.icards.eu\/sandbox\/&#039;;\nconst token = &#039;c76ac88badd96a37d1a7a744b4aecbdcad641d83&#039;;\nconst theme = &#039;classic&#039;;\nconst js = document.createElement(&#039;script&#039;);\njs.src = `${domain}js\/payment-modal.js?token=${token}&amp;theme=${theme}`;\njs.id = &#039;ipg-io-js&#039;;\njs.async = true;\ndocument.body.appendChild(js);\n&lt;\/script&gt;\n<\/code><\/pre>\n<h2>After completion<\/h2>\n<ol>\n<li>Wait for the PSP redirect callback.<\/li>\n<li>Call <code>GET \/api\/v1\/IndividualPaymentMethod\/{individualId}<\/code> to fetch the new card plus its <code>status<\/code> (e.g., <code>PendingReview<\/code>, <code>Active<\/code>).<\/li>\n<li>Use the returned <code>value<\/code> as <code>paymentMethodId<\/code> when initiating deposits.<\/li>\n<\/ol>\n<h2>Error codes<\/h2>\n<ul>\n<li><strong>400<\/strong> \u2013 user not eligible to add cards (finish onboarding first).<\/li>\n<li><strong>401<\/strong> \u2013 invalid bearer token.<\/li>\n<li><strong>404<\/strong> \u2013 individual ID unknown.<\/li>\n<li><strong>500<\/strong> \u2013 upstream PSP\/iCard outage.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"<p>Save Card via iCard (Gateway Initiate) Triggers the gateway-proxied iCard flow for registering a reusable payment method. Use it before listing cards with GET \/api\/v1\/IndividualPaymentMethod\/{individualId}. Endpoint POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualPaymentMethod\/{individualId}\/card-initiate Request body { &#8220;deviceIP&#8221;: &#8220;94.72.159.162&#8221; } Response (200) { &#8220;data&#8221;: &#8220;c76ac88badd96a37d1a7a744b4aecbdcad641d83&#8221;, &#8220;redirectUrl&#8221;: &#8220;https:\/\/dev-ipg.icards.eu\/sandbox\/&#8221; } Embed snippet &lt;div id=&#8221;ipg&#8221;&gt;&lt;\/div&gt; &lt;script&gt; const domain = &#8216;https:\/\/dev-ipg.icards.eu\/sandbox\/&#8217;; const token = &#8216;c76ac88badd96a37d1a7a744b4aecbdcad641d83&#8217;; [&hellip;]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[51],"doc_tag":[],"knowledge_base":[33],"class_list":["post-455","docs","type-docs","status-publish","hentry","doc_category-application-payment-methods","knowledge_base-10npay"],"year_month":"2026-06","word_count":182,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":[],"doc_category_info":[{"term_name":"Application Payment Methods","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/application-payment-methods\/"}],"doc_tag_info":[],"knowledge_base_info":[{"term_name":"10npay","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/","term_slug":"10npay"}],"knowledge_base_slug":["10npay"],"_links":{"self":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/455","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=455"}],"version-history":[{"count":1,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/455\/revisions"}],"predecessor-version":[{"id":459,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/455\/revisions\/459"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=455"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=455"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=455"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=455"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}