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": 1.00,
  "paymentMethodId": "temporary-token", // PSP token for this card
  "deviceIP": "192.0.2.15",
  "feeFromCard": true,
  "cardHolderName": "John Doe",
  "cardNumber": "411111******1111",
  "expiryMonth": "04",
  "expiryYear": "27",
  "cvv": "123"
}

(Exact structure depends on the PSP/tokenization: often the client sends a token in paymentMethodId instead of raw cardNumber/cvv.)

Response #

200 OK – returns CardOperationInitiateResponse 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.

Error codes #

• 400 – invalid card/token, unsupported currency, amount exceeds limits.
• 401 – missing/expired access token.
• 500 – PSP/gateway error, retry later.