2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
Help Center
VCCHUB How-to
2025-03-25
  • 2025-03-25
  • 2025-01-20
  • 2022-03-14
  1. Card
  • Guides
    • Welcome
    • Interface
  • API Reference
    • Introduction
    • Endpoints
    • Data Types
    • Signing
    • 3-D Secure Verification
    • Subscription
    • Errors
    • Webhooks
    • Items Information
    • Changelog
    • Acquiring
      • Create a direct payment
        POST
      • Create a redirect (iFrame) payment
        POST
      • Capture a transaction
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Cancel a subscription
        POST
      • Query a transaction
        POST
      • Refund a transaction
        POST
      • Search a refund transaction
        POST
      • Create a payout
        POST
      • Optimise payment methods
        POST
      • Update an order
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Card
        • Query card BIN
          POST
        • Create a card
          POST
        • Query card details
          POST
        • Recharge card
          POST
        • Withdraw from a card
          POST
        • Cancel a card
          POST
        • Update card status
          POST
        • Update card limit
          POST
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Card

Recharge card

POST
https://sandbox.vcc.top/api/card/charge
Recharge a card

Request

Body Params application/json
request_id
string 
optional
Unique identifier
<= 100 characters
company_id
number 
required
Merchant Code or Merchant ID or Merchant Number
charge_amount
string 
required
Recharge amount; Value can be digits only. Please refer to ISO 4217 for decimal values of each currency
<= 12 characters
card_id
number 
required
Card ID
sign
string 
required
Digital signatures information
Encryption Rule: touppercase(SHA256(company_id + card_id + charge_amount + api_key))
All encryption parameters need to remove spaces before encryption.
<= 100 characters
Example
{
  "request_id": "",
  "company_id": "4101",
  "charge_amount": "10",
  "card_id": "100029701",
  "sign": "0461E27872869CE387EFEB2243BEEB7048396F33E2AE47D3AF3F4C5AE9D0472B"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.vcc.top/api/card/charge' \
--header 'Content-Type: application/json' \
--data-raw '{
    "request_id": "",
    "company_id": "4101",
    "charge_amount": "10",
    "card_id": "100029701",
    "sign": "0461E27872869CE387EFEB2243BEEB7048396F33E2AE47D3AF3F4C5AE9D0472B"
}'

Responses

🟢200Success
application/json
Body
code
integer 
required
msg
object 
required
zh-CN
string 
required
en-US
string 
required
data
object 
required
status
string 
required
reqNo
integer 
required
errorMsg
null 
required
groupId
null 
required
Example
{
  "code": 0,
  "msg": {
    "zh-CN": "成功",
    "en-US": "Success"
  },
  "data": {
    "status": "1",
    "reqNo": 115801,
    "errorMsg": null,
    "groupId": null
  }
}
Previous
Query card details
Next
Withdraw from a card