{"id":316,"date":"2024-06-13T14:14:51","date_gmt":"2024-06-13T14:14:51","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=964"},"modified":"2026-05-21T14:13:57","modified_gmt":"2026-05-21T14:13:57","password":"","slug":"send-verification-code","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/send-verification-code\/","title":{"rendered":"Send Phone verification code"},"content":{"rendered":"

Send Phone Verification Code<\/h1>\n

Sends a one-time SMS code to the user so they can confirm ownership of their phone number.<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/User\/phone-number\/send-code\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  \"id\": 2077,\n  \"phoneNumber\": \"+359881234567\",\n  \"correlationType\": 0\n}\n<\/code><\/pre>\n\n\n\n\n\n\n\n
    Field<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    id<\/code><\/td>\ninteger (int32)<\/td>\nUser identifier returned by POST \/User<\/code>. Required.<\/td>\n<\/tr>\n
    phoneNumber<\/code><\/td>\nstring<\/td>\nPhone number in E.164 format (+[country][number]<\/code>). Required.<\/td>\n<\/tr>\n
    correlationType<\/code><\/td>\ninteger (enum)<\/td>\nOptional — 0<\/code> for standard individual users (default), 1<\/code> for merchant flows.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    Responses<\/h2>\n
      \n
    • 204 No Content<\/strong> — SMS dispatched (or the user is already verified, in which case the call is still idempotent).<\/li>\n
    • 400 Bad Request<\/strong> — invalid format or phone already registered.<\/li>\n
    • 401 Unauthorized<\/strong> — missing\/expired Bearer token.<\/li>\n
    • 404 Not Found<\/strong> — unknown userId<\/code>.<\/li>\n
    • 5xx Server Error<\/strong> — transient failure (retry with backoff).<\/li>\n<\/ul>\n
      Notes<\/h2>\n
        \n
      • Apply local validation and throttling (e.g., minimum delay between resend attempts).<\/li>\n
      • The server enforces uniqueness: if the phone is already linked to another user, the call returns 400<\/code>.<\/li>\n
      • After the code is sent, prompt the user to call POST \/User\/phone-number\/verify<\/code> with the received digits.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
        Send Phone Verification Code Sends a one-time SMS code to the user so they can confirm ownership of their phone number. Endpoint POST https:\/\/api-test.10npay.com\/User\/phone-number\/send-code Headers Authorization: Bearer <access_token> Content-Type: application\/json Request Body { “id”: 2077, “phoneNumber”: “+359881234567”, “correlationType”: 0 } Field Type Description id integer (int32) User identifier returned by POST \/User. Required. phoneNumber string […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[55],"doc_tag":[],"knowledge_base":[33],"class_list":["post-316","docs","type-docs","status-publish","hentry","doc_category-create-customer","knowledge_base-10npay"],"year_month":"2026-05","word_count":177,"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":"Create - Customer","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/create-customer\/"}],"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\/316","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=316"}],"version-history":[{"count":2,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/316\/revisions"}],"predecessor-version":[{"id":385,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/316\/revisions\/385"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=316"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=316"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=316"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=316"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}