{"id":328,"date":"2024-06-14T14:34:22","date_gmt":"2024-06-14T14:34:22","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=1041"},"modified":"2026-05-21T17:15:51","modified_gmt":"2026-05-21T17:15:51","password":"","slug":"create-payment-method-iban","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/create-payment-method-iban\/","title":{"rendered":"Create Payment Method \u2013 IBAN"},"content":{"rendered":"

Create Payment Method \u2013 IBAN<\/h1>\n

Registers an IBAN-based payment method for an individual user (e.g., external bank account for payouts).<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualPaymentMethod\/{individualId}\/iban\n<\/code><\/pre>\n
Headers<\/h2>\n
    \n
  • Authorization: Bearer <access_token><\/code><\/li>\n
  • Content-Type: application\/json<\/code><\/li>\n
  • Accept: application\/json<\/code><\/li>\n<\/ul>\n
    Path Parameter<\/h2>\n\n\n\n\n\n
    Name<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    individualId<\/code><\/td>\nCRM individual ID (same one returned after onboarding).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Request Body<\/h2>\n
    {\n  \"accountName\": \"Acme OOD\",\n  \"bankName\": \"Bank of Somewhere\",\n  \"bankStatement\": \"BASE64...\",\n  \"bankStatementFileName\": \"statement.pdf\",\n  \"ibanNumber\": \"BG66TEST12345678901234\",\n  \"swift\": \"TESTBGSF\",\n  \"currency\": \"BGN\",\n  \"status\": \"PendingReview\"\n}\n<\/code><\/pre>\n
    Fields & Validation<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n
    Field<\/th>\nRules<\/th>\n<\/tr>\n<\/thead>\n
    accountName<\/code><\/td>\nRequired. Latin\/Cyrillic letters, length < 150 (per Constants.NameLength<\/code>).<\/td>\n<\/tr>\n
    bankName<\/code><\/td>\nRequired. Must match institution-name regex (letters, digits, punctuation).<\/td>\n<\/tr>\n
    bankStatement<\/code><\/td>\nRequired. Base64-encoded PDF\/image; must pass regex + base64 validation.<\/td>\n<\/tr>\n
    bankStatementFileName<\/code><\/td>\nRequired. File name \u2264 255 chars, matches file-name regex.<\/td>\n<\/tr>\n
    ibanNumber<\/code><\/td>\nRequired. Must be a valid IBAN (ISO 13616 check).<\/td>\n<\/tr>\n
    swift<\/code><\/td>\nRequired. Must match SWIFT\/BIC regex.<\/td>\n<\/tr>\n
    currency<\/code><\/td>\nISO 4217, 3 uppercase letters; must be supported currency.<\/td>\n<\/tr>\n
    status<\/code><\/td>\nOne of the PaymentMethodStatus<\/em> enum keys (e.g., PendingReview<\/code>, Active<\/code>).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Responses<\/h2>\n
      \n
    • 200 OK<\/strong> \u2013 IBAN registered (empty body; status transitions to review\/approval).<\/li>\n
    • 400 Bad Request<\/strong> \u2013 validation failure. Example:\n
      {\n  \"errors\": {\n    \"Error\": [\n      \"'SWIFT Code' is not valid.\",\n      \"'Currency' must be three uppercase letter.\",\n      \"'Bank Statement' is not valid.\"\n    ]\n  },\n  \"title\": \"Bad Request\",\n  \"status\": 400\n}\n<\/code><\/pre>\n<\/li>\n
    • 404 Not Found<\/strong> \u2013 individual not found \/ inactive.<\/li>\n
    • 500 Internal Server Error<\/strong> \u2013 unexpected backend failure.<\/li>\n<\/ul>\n
      Notes<\/h2>\n
        \n
      • The individual must be Active and have <= 20 payment methods in total.<\/li>\n
      • Provide a recent bank statement (PDF\/JPG) encoded as Base64 to comply with KYC.<\/li>\n
      • Use GET \/api\/v1\/IndividualPaymentMethod\/{individualId}<\/code> to check the review state after submission.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Create Payment Method \u2013 IBAN Registers an IBAN-based payment method for an individual user (e.g., external bank account for payouts). Endpoint POST https:\/\/api-test.10npay.com\/api\/v1\/IndividualPaymentMethod\/{individualId}\/iban Headers Authorization: Bearer <access_token> Content-Type: application\/json Accept: application\/json Path Parameter Name Description individualId CRM individual ID (same one returned after onboarding). Request Body { “accountName”: “Acme OOD”, “bankName”: “Bank of Somewhere”, “bankStatement”: […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[51],"doc_tag":[],"knowledge_base":[33],"class_list":["post-328","docs","type-docs","status-publish","hentry","doc_category-application-payment-methods","knowledge_base-10npay"],"year_month":"2026-07","word_count":248,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"10npaydev","author_nicename":"10npaydev","author_url":"https:\/\/developers.10npay.com\/bg\/author\/10npaydev\/"},"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\/328","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\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/comments?post=328"}],"version-history":[{"count":1,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/328\/revisions"}],"predecessor-version":[{"id":407,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/328\/revisions\/407"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=328"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=328"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=328"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=328"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}