{"id":334,"date":"2024-06-14T15:20:29","date_gmt":"2024-06-14T15:20:29","guid":{"rendered":"https:\/\/developers.10npay.com\/?post_type=docs&p=1073"},"modified":"2026-05-22T08:22:23","modified_gmt":"2026-05-22T08:22:23","password":"","slug":"deposit-with-card-one-time","status":"publish","type":"docs","link":"https:\/\/developers.10npay.com\/bg\/docs\/deposit-with-card-one-time\/","title":{"rendered":"Deposit with card (one time)"},"content":{"rendered":"

Deposit with Card (One-Time)<\/h1>\n

Initiates a deposit from a new card (not saved as a payment method). The mobile app collects card data, tokenizes it, and calls the gateway endpoint to start the PSP\/3DS flow.<\/p>\n

Endpoint<\/h2>\n
POST https:\/\/api-test.10npay.com\/app\/deposit-money-from-new-card-initiate\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 (example)<\/h2>\n
    {\n  \"accountNumber\": \"BG56TEPJ40131000100196\",\n  \"transactionAmount\": 50.00,\n  \"transactionCurrency\": \"BGN\",\n  \"transactionCharge\": 1.00,\n  \"paymentMethodId\": \"temporary-token\", \/\/ PSP token for this card\n  \"deviceIP\": \"192.0.2.15\",\n  \"feeFromCard\": true,\n  \"cardHolderName\": \"John Doe\",\n  \"cardNumber\": \"411111******1111\",\n  \"expiryMonth\": \"04\",\n  \"expiryYear\": \"27\",\n  \"cvv\": \"123\"\n}\n<\/code><\/pre>\n
    (Exact structure depends on the PSP\/tokenization: often the client sends a token in paymentMethodId<\/code> instead of raw cardNumber\/cvv.)<\/p>\n
    Response<\/h2>\n
    200 OK<\/strong> \u2013 returns CardOperationInitiateResponse<\/code> containing HTML form\/URL for 3-D Secure (Borica\/PSP). Display it to the user (WebView). Once the PSP redirects back with success, finalize the deposit using the same status callbacks as the saved-card flow.<\/p>\n
    Error codes<\/h2>\n
      \n
    • 400<\/strong> \u2013 invalid card\/token, unsupported currency, amount exceeds limits.<\/li>\n
    • 401<\/strong> \u2013 missing\/expired access token.<\/li>\n
    • 500<\/strong> \u2013 PSP\/gateway error, retry later.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"
      Deposit with Card (One-Time) Initiates a deposit from a new card (not saved as a payment method). The mobile app collects card data, tokenizes it, and calls the gateway endpoint to start the PSP\/3DS flow. Endpoint POST https:\/\/api-test.10npay.com\/app\/deposit-money-from-new-card-initiate Headers Authorization: Bearer <access_token> Content-Type: application\/json Request Body (example) { “accountNumber”: “BG56TEPJ40131000100196”, “transactionAmount”: 50.00, “transactionCurrency”: “BGN”, “transactionCharge”: […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[52],"doc_tag":[],"knowledge_base":[33],"class_list":["post-334","docs","type-docs","status-publish","hentry","doc_category-payment-operation-incl-call-for-fee-calculation","knowledge_base-10npay"],"year_month":"2026-07","word_count":158,"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":"Payment Operation (incl. Call for fee calculation)","term_url":"https:\/\/developers.10npay.com\/bg\/docs\/10npay\/payment-operation-incl-call-for-fee-calculation\/"}],"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\/334","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=334"}],"version-history":[{"count":1,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/334\/revisions"}],"predecessor-version":[{"id":418,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/docs\/334\/revisions\/418"}],"wp:attachment":[{"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/media?parent=334"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_category?post=334"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/doc_tag?post=334"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/developers.10npay.com\/bg\/wp-json\/wp\/v2\/knowledge_base?post=334"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}