{"id":243,"date":"2023-06-09T08:08:07","date_gmt":"2023-06-09T08:08:07","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=51"},"modified":"2026-05-21T16:03:02","modified_gmt":"2026-05-21T16:03:02","password":"","slug":"create-wallet","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/create-wallet\/","title":{"rendered":"Create Wallet"},"content":{"rendered":"

Create Wallet<\/h1>\n

Creates a wallet for an onboarded individual in a specific currency.<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualWallet\/create-wallet\n<\/code><\/pre>\n
Headers<\/h2>\n
    \n
  • Authorization: Bearer <access_token><\/code><\/li>\n
  • Content-Type: application\/json<\/code><\/li>\n<\/ul>\n
    Request Body<\/h2>\n
    {\n  \"individualId\": 123,\n  \"currency\": \"BGN\"\n}\n<\/code><\/pre>\n\n\n\n\n\n\n
    Field<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    individualId<\/code><\/td>\nIdentifier returned when the individual record was created. Required.<\/td>\n<\/tr>\n
    currency<\/code><\/td>\nThree-letter ISO currency code (e.g., BGN<\/code>, EUR<\/code>). Required.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Response — 200 OK<\/h2>\n
    {\n  \"id\": 456,\n  \"currency\": \"BGN\"\n}\n<\/code><\/pre>\n
    Errors<\/h2>\n
      \n
    • 400 Bad Request<\/strong> — invalid currency or wallet already exists.<\/li>\n
    • 401 Unauthorized<\/strong> — missing\/expired token.<\/li>\n
    • 404 Not Found<\/strong> — unknown individualId<\/code>.<\/li>\n
    • 5xx<\/strong> — transient backend error.<\/li>\n<\/ul>\n
      Notes<\/h2>\n
        \n
      • One wallet per currency per individual. Attempting to create an existing wallet returns a validation error.<\/li>\n
      • Call this right after the onboarding\/KYC flow is finalized to provision the primary wallet.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"
        Create Wallet Creates a wallet for an onboarded individual in a specific currency. Endpoint POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualWallet\/create-wallet Headers Authorization: Bearer <access_token> Content-Type: application\/json Request Body { “individualId”: 123, “currency”: “BGN” } Field Description individualId Identifier returned when the individual record was created. Required. currency Three-letter ISO currency code (e.g., BGN, EUR). Required. Response — 200 OK […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[50],"doc_tag":[],"knowledge_base":[33],"class_list":["post-243","docs","type-docs","status-publish","hentry","doc_category-create-account-iban","knowledge_base-10npay"],"year_month":"2026-06","word_count":123,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"","author_nicename":"","author_url":"https:\/\/developers.10npay.com\/bg\/author\/"},"doc_category_info":[{"term_name":"Create - Account\/IBAN","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/create-account-iban\/"}],"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\/243","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"}],"author":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=243"}],"version-history":[{"count":2,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/243\/revisions"}],"predecessor-version":[{"id":399,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/243\/revisions\/399"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=243"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=243"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=243"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=243"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}