List all virtual card offers
Fetch all virtual card offers created on Peerwallet, you would need the offer id of a particular virtual card when you want to create a card from that Merchant.
All created cards can also be managed from the peerwallet dashboard form the ‘My shop - My Virtual Cards’ menu.
CALL URL: https://calls.peerwallet.com/vcard-list
End Point
"https://calls.peerwallet.com
/vcard-list"
Send your keys via headers
VALUE
api-public-key
REQUIRED
YES
DESCRIPTION
Here is your public key. To use this, please make sure the API status is turned on.
Return Sample
{
"status": 200,
"data":{
"offer_id":"GTFTIU988T" ,
"merchant": "Test Merchant" ,
"card_primary_currency": "GBP" ,
"selling_currency":"EUR" ,
"type": "Virtual" ,
"issuer": "Mastercard",
"allow_custom_name": yes ,
"allow_custom_address": No ,
"custom_address_allowed_for_countries": "Allow None" ,
"only_verified_users": "No" ,
"loading_fee_percentage":"12" ,
"fixed_loading_fee":"0" ,
"creation_cost": "3" ,
"card_monthly_fee":"3" ,
"minimum_load_fee": "0" ,
"min_load": "2" ,
"max_load":"500" ,
"total_accumulated_load":"25000" ,
"restricted_countries": "3" ,
"Allow All":"3" ,
"status": "active" ,
"admin_approval": "approved"
},
"note": "Virtual cards successfully fetched"
}
Create virtual cards
You can create virtual cards via the API easily, if the vendors allows multiple and unlimited creation, you can do this via this API.
CALL URL: https://calls.peerwallet.com/vcard-issue
End Point
"https://calls.peerwallet.com
/vcard-issue"
Send your keys via headers
VALUE
api-private-key
REQUIRED
YES
DESCRIPTION
Here is your private key. To use this, please make sure the API status is turned on.
Below are the variables to be sent and their meaning.
VALUE
offer_id
REQUIRED
YES
DESCRIPTION
This is the id of the offer
amount
YES
This is the amount you want to load. The total to be paid would be the following; Amount + loading fee or minimum load fee + card cost + peerwallet fee + loading_fixed_fee (if set) Check all of these values from the list virtual cards offer call.
Return Sample
{
"status": 200,
"card_status":"success" ,
"identifier": "3636apfyjwfiuwg62987bvcsvog" ,
"card_id": "FJG96674T3" ,
"amount":200 ,
"charged_currency": "EUR" ,
"card_total": 185,
"fee_in_local_currency": 0.6 ,
"total_charged_in_local_currency": 430 ,
"date":439483409 ,
"date_text": "Mon, 5th of June 2022" ,
"merchant":"Test Merchant" ,
"receipt_url":"https://peerwallet.com/map
/receipt?token=UG78gHGDGY87pwI
hjgbhzxbnlhfgueirewydoopelFUh85u" ,
"note": "Card creation was succesful"
}
Fetch created card details
Here you can fetch the details of a card previously created using the ‘identifier’ value generated when creating the card.
CALL URL: https://calls.peerwallet.com/vcard-fetch-card-details
End Point
"https://calls.peerwallet.com
/vcard-fetch-card-details"
Send your keys via headers
VALUE
api-private-key
REQUIRED
YES
DESCRIPTION
Here is your private key. To use this, please make sure the API status is turned on.
Below are the variables to be sent and their meaning.
VALUE
offer_id
REQUIRED
YES
DESCRIPTION
This is the id of the offer
identifier
YES
This is the id generated when the card was created
Return Sample
{
"status": "200",
"merchant":"Test Merchant" ,
"nickname": "my quick card" ,
"data":{
"card_num":-8770 ,
"card_name": "John Doe" ,
"card_primary_currency": "USD" ,
"card_balance":"30" ,
"exp_month": "01" ,
"exp_year": 29,
"cvv": 342 ,
"billing_address": test road street ,
"billing_city": "test city" ,
"billing_state": "test state" ,
"billing_postal_code":902932 ,
"billing_country":billing_country ,
"billing_country": "test country" ,
},
"note": "Virtual card details successfully fetched"
}
Load virtual card
You can top-up a card, the offer needs to remain active to be able to load the card.
CALL URL: https://calls.peerwallet.com/vcard-load
End Point
"https://calls.peerwallet.com
/vcard-load"
Send your keys via headers
VALUE
api-private-key
REQUIRED
YES
DESCRIPTION
Here is your private key. To use this, please make sure the API status is turned on.
Below are the variables to be sent and their meaning.
VALUE
offer_id
REQUIRED
YES
DESCRIPTION
This is the id of the offer
identifier
YES
This the unique token generated when creating the card
amount
YES
The amount you want to load, in the selling currency of the card
Return Sample
{
"status": 200,
"load_status":"success" ,
"identifier": "534753FH9T96T7t349837434" ,
"amount":34 ,
"charged_currency": "EUR" ,
"card_total": 36 ,
"fee_in_local_currency":0.1 ,
"total_charged_in_local_currency": 33210 ,
"date": 439309432,
"date_text": "15th of May, 2022" ,
"merchant": Test Merchant ,
"receipt_url": "https://peerwallet.com/map/receipt?token=363wuyAvbcxspoiuw89gyug
iuxcAQID0dwrpIJGYgyuCVBNC
RDUR6D686fg",
"note": "Card load was succesful"
}
Fetch Card Transactions
You can fetch the transactions done on a card easily, send the required fields for a response.
CALL URL: https://calls.peerwallet.com/vcard-fetch-card-trans
End Point
"https://calls.peerwallet.com
/vcard-fetch-card-trans"
Send your keys via headers
VALUE
api-private-key
REQUIRED
YES
DESCRIPTION
Here is your private key. To use this, please make sure the API status is turned on.
Below are the variables to be sent and their meaning.
VALUE
offer_id
REQUIRED
YES
DESCRIPTION
This is the id of the offer
identifier
YES
This the unique token generated when creating the card
Return Sample
{
"status": 200,
"data":[
"transactions":"data--" ]
}
List all created virtual cards
This would list out all the virtual cards your account has created.
CALL URL: https://calls.peerwallet.com/vcard-list-my-cards
End Point
"https://calls.peerwallet.com
/vcard-list-my-cards"
Send your keys via headers
VALUE
api-public-key
REQUIRED
YES
DESCRIPTION
Here is your private key. To use this, please make sure the API status is turned on.
Return Sample
{
"status": 200,
"data":{
"identifier":"YGUvduywt696924tyughskf" ,
"offer_id": "0734 IGOKSB" ,
"card_id": "PRFJISDFDGG" ,
"merchant":"The test merchant" ,
"card_primary_currency": "GBP" ,
"type": "Virtual",
"issuer": "Visa" ,
"date_created": 5359802834 ,
"status": "active"
},
}
