API
  1. Card
API
  • 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
      • Query a transaction
        POST
      • Optimise payment methods
        POST
      • Search a refund transaction
        POST
      • Refund a transaction
        POST
      • Update an order
        POST
      • Review a transaction
        POST
      • Cancel a transaction
        POST
      • Capture a transaction
        POST
      • Create a payout
        POST
    • Issuing
      • Cardholder
        • Create cardholder
          POST
        • Delete cardholder
          POST
        • Query cardholder
          POST
      • Group
        • Create group
        • Query group details
        • Cancel group
        • Refund group
        • Update group status
        • Recharge group
      • Card
        • Create a card
          POST
        • Query card BIN
          POST
        • Recharge card
          POST
        • Withdraw from a card
          POST
        • Cancel a card
          POST
        • Update card status
          POST
        • Update card limit
          POST
        • Query card details
          POST
  • Appendix
    • Test Cards
    • Bank Code
    • Country Code
    • Currency Code
    • Payment Methods
  1. Card

Recharge card

POST
/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 BIN
Next
Withdraw from a card