API Documentation

Integrate with our card issuing platform. All API requests should be sent with the `Content-Type: application/json` header.

Authentication: All API requests must include your publickey and secretkey in the request headers.

EURO-MASTER API

Use these endpoints to issue, retrieve, fund, freeze, unfreeze, and inspect EUR virtual Mastercard cards. All requests require publickey and secretkey headers.

Create Card

Issue a new EURO-MASTER virtual card. The issuance fee is debited from the funding wallet.

Endpoint: POST /api/createcard

Request Body Parameters:

  • firstName (required): Cardholder first name
  • lastName (required): Cardholder last name
  • email (required): Cardholder email address
curl -X POST https://pagocards.com/api/createcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "firstName": "John",
  "lastName": "Doe",
  "email": "joe@doe.com"
}'
{
  "firstName": "John",
  "lastName": "Doe",
  "email": "joe@doe.com"
}
{
  "cardid": "6a2aa482e9458beedaf70636",
  "useremail": "joe@doe.com",
  "nameoncard": "John Doe"
}

Get Card

Retrieve current status, balance, currency, and stored card metadata.

Endpoint: POST /api/getcard

Request Body Parameters:

  • cardid (required): Card ID returned from create card
  • email (required): Cardholder email address
curl -X POST https://pagocards.com/api/getcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}
{
  "cardid": "6a2aa482e9458beedaf70636",
  "useremail": "joe@doe.com",
  "nameoncard": "John Doe",
  "brand": "newmaster",
  "type": "virtual",
  "currency": "EUR",
  "status": "active",
  "balance": 1.7
}

Get All Cards

Retrieve all EURO-MASTER cards for a specific cardholder email.

Endpoint: POST /api/getallcards

Request Body Parameters:

  • email (required): Cardholder email address
curl -X POST https://pagocards.com/api/getallcards \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "email": "joe@doe.com"
}'
{
  "email": "joe@doe.com"
}
{
  "cards": [
    {
      "cardid": "6a2aa482e9458beedaf70636",
      "useremail": "joe@doe.com",
      "lastfour": "1234",
      "brand": "newmaster",
      "type": "virtual"
    }
  ]
}

Get Exchange Rate

Retrieve the current FX rate used for EURO-MASTER wallet to card conversions.

Endpoint: GET /api/getfx

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key
curl -X GET https://pagocards.com/api/getfx \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"
{
  "status": "success",
  "fx": {
    "rate": 0.92,
    "comission": 0,
    "value": 0.92
  }
}

Get Sensitive

Retrieve a signed JavaScript embed URL that displays sensitive card details in an iframe.

Endpoint: POST /api/getcardsensitive

Request Body Parameters:

  • cardid (required): Card ID returned from create card
  • email (required): Cardholder email address
curl -X POST https://pagocards.com/api/getcardsensitive \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}
{
  "cardid": "6a2aa482e9458beedaf70636",
  "useremail": "joe@doe.com",
  "cardnumber": "",
  "cvc" : "",
  "month": "",
  "url": "https://pagocards.com/api/cards/sensitive/embed.js?payload=...&signature=...",
  "message": "Embed this card details URL in a <script src='<url>'></script> tag in your card details screen to display sensitive card information."
}

Fund Card

Fund a EURO-MASTER card. Send the original USDC amount. The live USDC to EUR rate is fetched when the transfer executes.

Endpoint: POST /api/fundcard

Request Body Parameters:

  • cardid (required): Card ID returned from create card
  • email (required): Cardholder email address
  • amount (required): Amount in USDC. Minimum is 3.
curl -X POST https://pagocards.com/api/fundcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "amount": 25
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "amount": 25
}
{
  "status": "success",
  "reference": "PGC-REFERENCE",
  "transaction_id": "provider-transaction-id",
  "amount": 25,
  "amount_eur": 21.25,
  "fee": 1.25,
  "code": 200
}

Withdraw from Card

Withdraw funds from a EURO-MASTER card. The amount is returned to your funding wallet, minus a $1 fee.

Endpoint: POST /api/withdraw

Request Body Parameters:

  • cardid (required): Card ID
  • email (required): Cardholder email address
  • amount (required): Amount in USDC to withdraw. Must be greater than 1.
curl -X POST https://pagocards.com/api/withdraw \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "amount": 10
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "amount": 10
}
{
  "status": "success",
  "cardid": "6a2aa482e9458beedaf70636",
  "useremail": "joe@doe.com",
  "euro_amount": 7.5,
  "usdc_amount": 9,
  "transactionId": "provider-transaction-id"
}

Get Transactions

Retrieve paginated transactions for a EURO-MASTER card.

Endpoint: POST /api/gettransactions

Request Body Parameters:

  • cardid (required): Card ID returned from create card
  • email (required): Cardholder email address
  • page (optional): Page number
  • limit (optional): Number of transactions per page
  • dateFrom, dateTo, types, dateSort (optional): Provider transaction filters
curl -X POST https://pagocards.com/api/gettransactions \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "page": 1,
  "limit": 10
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com",
  "page": 1,
  "limit": 10
}
{
  "status": "success",
  "data": {
    "transactions": [
      {
        "id": "60a7c8b5f1d2c3a5b4e3f678",
        "amount": 100.5,
        "currency": "USD",
        "settledAmount": 110.5,
        "merchant": "MERCHANT",
        "mcc": "0000",
        "type": ["AUTHORIZATION"],
        "status": ["APPROVED"],
        "transactionDate": "2024-03-24T12:34:56.789Z",
        "clearingTransactionDate": "2024-03-24T12:34:56.789Z",
        "declineReason": null
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "pages": 3,
      "total": 22
    }
  }
}

Block Card

Freeze a EURO-MASTER card.

Endpoint: POST /api/blockcard

curl -X POST https://pagocards.com/api/blockcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}

Unblock Card

Unfreeze a EURO-MASTER card.

Endpoint: POST /api/unblockcard

curl -X POST https://pagocards.com/api/unblockcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}

Terminate Card

Permanently terminate a EURO-MASTER card. A $1 fee is applicable.

Endpoint: POST /api/terminatecard

curl -X POST https://pagocards.com/api/terminatecard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}'
{
  "cardid": "6a2aa482e9458beedaf70636",
  "email": "joe@doe.com"
}

Webhooks

EURO-MASTER webhook events are sent to your configured webhook URL. The payload structure depends on the event type.

Transaction Event

{
  "type": "transaction",
  "data": {
    "cardId": "string",
    "id": "string",
    "amount": "number",
    "currency": "string",
    "settledAmount": "number",
    "merchant": "string",
    "transactionDate": "date",
    "clearingDate": "date",
    "declineReason": "string",
    "type": ["AUTHORIZATION", "REFUND"],
    "status": ["APPROVED", "FAILED", "CLEARED"],
    "mcc": "string",
    "merchantId": "string",
    "merchantCountry": "string"
  }
}

Extra Fee Event

{
  "type": "extraFee",
  "data": {
    "type": ["transaction"],
    "amount": "number",
    "currency": "string",
    "settledAmount": "number",
    "cardId": "string",
    "from": ["master-account", "card"],
    "status": ["success"]
  }
}

Card Issue Event

{
  "type": "card-issue",
  "data": {
    "id": "string",
    "status": "success | failed"
  }
}

3DS Event

{
  "status": "success",
  "type": "3ds",
  "data": {
    "id": "string",
    "status": ["APPROVED", "DECLINED", "PENDING"],
    "amount": {
      "amount": "number",
      "currency": "string"
    },
    "merchant": {
      "name": "string",
      "country": "string"
    },
    "card": {
      "cardId": "string"
    }
  }
}

Card State Event

{
  "status": "success",
  "type": "card-state",
  "data": {
    "id": "string",
    "cardBalance": "number",
    "maskedCardNumber": "string",
    "status": ["active", "deleted", "freezed", "pending", "failed", "expired", "blocked"]
  }
}

Visacard API

An Initial Loading of $3 is required per card issuance. If your user card balance is insufficient, Decline Fees and Cross border fees will be debited from your main wallet. Decline Fees: $0.75 (second onwards), FX Fee: 2% + $0.5

Create Visacard

Creates a new virtual Visacard.

Endpoint: POST /api/visacard/createcard

curl -X POST https://pagocards.com/api/visacard/createcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "firstname": "Jane",
  "lastname": "Doe",
  "email": "jane.doe@example.com"
}'
{
  "firstname": "Jane",
  "lastname": "Doe",
  "email": "jane.doe@example.com"
}

Fund Visacard

Funds a Visacard from your visa wallet. A topup fee of $1 + 1% applies.

Endpoint: POST /api/visacard/fundcard

curl -X POST https://pagocards.com/api/visacard/fundcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "card_yyyyyyyyyyyy",
  "email": "jane.doe@example.com",
  "amount": 25
}'
{
  "cardid": "card_yyyyyyyyyyyy",
  "email": "jane.doe@example.com",
  "amount": 25
}

Get Card Details

Retrieves details for a specific Visacard.

Endpoint: POST /api/visacard/getcard

curl -X POST https://pagocards.com/api/visacard/getcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "email": "jane.doe@example.com",
  "cardid": "card_yyyyyyyyyyyy"
}'
{
  "email": "jane.doe@example.com",
  "cardid": "card_yyyyyyyyyyyy"
}

Get All Cards

Retrieves a list of all Visacards for a specific user email.

Endpoint: POST /api/visacard/getallcards

curl -X POST https://pagocards.com/api/visacard/getallcards \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "email": "jane.doe@example.com"
}'
{
  "email": "jane.doe@example.com"
}

Block / Unblock Card

Blocks or unblocks a specific Visacard.

Endpoints:

  • POST /api/visacard/blockcard
  • POST /api/visacard/unblockcard
curl -X POST https://pagocards.com/api/visacard/blockcard \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "email": "jane.doe@example.com",
  "cardid": "card_yyyyyyyyyyyy"
}'
{
  "email": "jane.doe@example.com",
  "cardid": "card_yyyyyyyyyyyy"
}

Spend Controls

Update spending limits and merchant/category controls for a Visa card. All spend-limit fields are optional.

Endpoint: PUT /api/visacard/spendcontrols

Request Body Parameters:

  • cardid (required): The unique identifier of the card
  • email (required): The email address of the card owner
  • single_transaction (optional): Single transaction limit
  • daily (optional): Daily spending limit
  • weekly (optional): Weekly spending limit
  • monthly (optional): Monthly spending limit
  • allowed_categories (optional): Allowed categories array
  • blocked_categories (optional): Blocked categories array
  • allowed_merchants (optional): Allowed merchants array
  • blocked_merchants (optional): Blocked merchants array
curl -X PUT https://pagocards.com/api/visacard/spendcontrols \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "card_yyyyyyyyyyyy",
  "email": "jane.doe@example.com",
  "single_transaction": "2000.00",
  "daily": "10000.00",
  "weekly": "40000.00",
  "monthly": "100000.00",
  "allowed_categories": ["travel", "software", "office_supplies"],
  "blocked_categories": ["gambling", "adult_content"],
  "allowed_merchants": [],
  "blocked_merchants": ["merchant_123"]
}'
{
  "cardid": "card_yyyyyyyyyyyy",
  "email": "jane.doe@example.com",
  "single_transaction": "2000.00",
  "daily": "10000.00",
  "weekly": "40000.00",
  "monthly": "100000.00",
  "allowed_categories": ["travel", "software", "office_supplies"],
  "blocked_categories": ["gambling", "adult_content"],
  "allowed_merchants": [],
  "blocked_merchants": ["merchant_123"]
}
{
  "status": "success",
  "message": "Spending limits updated successfully",
  "code": 200,
  "data": {
    "card_id": "card_yyyyyyyyyyyy",
    "operation": "update_spending_limits",
    "spending_limits": {
      "single_transaction": "2000.00",
      "daily": "10000.00",
      "weekly": "40000.00",
      "monthly": "100000.00",
      "allowed_categories": ["travel", "software", "office_supplies"],
      "blocked_categories": ["gambling", "adult_content"],
      "allowed_merchants": [],
      "blocked_merchants": ["merchant_123"]
    },
    "updated_at": "2024-01-15T15:00:00Z"
  }
}

Terminate Card

Terminate a Visa card by sending a deletion request.

Endpoint: POST /api/terminate

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key
  • Content-Type: application/json

Request Body Parameters:

  • cardid (required): The unique identifier of the card to terminate
  • email (required): The email address of the card owner
curl -X POST https://pagocards.com/api/terminate \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "cardid": "card_abc123xyz",
  "email": "user@example.com"
}'
{
  "cardid": "card_abc123xyz",
  "email": "user@example.com"
}

See POSTMAN collection

Giftcards API

Get All Giftcards

Retrieve a paginated list of all available giftcards in the catalog. You can filter the results using query parameters.

Endpoint: GET /api/getgiftcards

Query Parameters:

  • page (optional): Page number (default: 1)
  • limit (optional): Number of items per page (default: 20)
  • search (optional): Search by title, currency, or region
  • country (optional): Filter by region/country
  • currency (optional): Filter by exact currency code (e.g., USD)
curl -X GET "https://pagocards.com/api/getgiftcards?page=1&limit=20&search=amazon" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Get Giftcard By SKU

Retrieve details of a specific giftcard using its SKU.

Endpoint: GET /api/getgiftcard/{sku}

curl -X GET https://pagocards.com/api/getgiftcard/1000 \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Get Exchange Rates

Fetch the current exchange rates required if purchasing giftcards priced in currencies other than USD.

Endpoint: GET /api/getexchangerates

curl -X GET https://pagocards.com/api/getexchangerates \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Check SKU Availability

Verify if a specific quantity and price of a giftcard SKU is available for purchase before placing an order.

Endpoint: GET /api/checkskuavailability/{sku}?item_count=1&price=10.00

curl -X GET "https://pagocards.com/api/checkskuavailability/1000?item_count=1&price=25.00" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Purchase Giftcard

Purchase a giftcard using the user's giftcard wallet balance. The total cost is automatically deducted.

Endpoint: POST /api/purchasegiftcard

curl -X POST https://pagocards.com/api/purchasegiftcard \
-H "Content-Type: application/json" \
-d '{
  "sku": "1000",
  "quantity": 1,
  "amount": 25.00,
  "publickey": "YOUR_PUBLIC_KEY",
  "secretkey": "YOUR_SECRET_KEY"
}'
{
  "sku": "1000",
  "quantity": 1,
  "amount": 25.00,
  "publickey": "YOUR_PUBLIC_KEY",
  "secretkey": "YOUR_SECRET_KEY"
}

Get Giftcard Order

Retrieve details and the share link for a specific purchased giftcard order using its reference code.

Endpoint: GET /api/getgiftcardorder/{referencecode}

curl -X GET https://pagocards.com/api/getgiftcardorder/01c79b97-8ab4-423c-a11d-225897f2135a \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Get Giftcard Order History

Retrieve a paginated list of all giftcard purchase records associated with the API key.

Endpoint: GET /api/getgiftcardorderhistory

Query Parameters:

  • page (optional): Page number (default: 1)
  • limit (optional): Number of items per page (default: 20)
curl -X GET "https://pagocards.com/api/getgiftcardorderhistory?page=1&limit=20" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"

Payouts API

Use these endpoints to create payout quotes and initialize payouts. Both requests require publickey and secretkey headers.

Current only USD ACH to US Banks is supported. SEPA EUR transfers coming soon.

Get Payout Quote

Endpoint: POST /api/payouts/getpayoutquote

curl -X POST https://pagocards.com/api/payouts/getpayoutquote \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "to_currency": "USD",
  "country": "US",
  "amount": "1000"
}'
{
  "to_currency": "USD",
  "country": "US",
  "amount": "1000"
}

Initialize Payout

Initialize and finalize a payout for an existing quote.

Endpoint: POST /api/payouts/{quoteId}/initialize

Allowed Values:

  • account_type: checking or savings
  • beneficiary.type: individual or business
curl -X POST https://pagocards.com/api/payouts/QT2_21362485/initialize \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "account_type": "checking",
  "account_number": "0123456789",
  "routing_number": "021000021",
  "bank_name": "Access Bank",
  "bank_address": "123 Main Street",
  "post_code": "10001",
  "city": "New York",
  "state": "New York",
  "country": "US",
  "beneficiary": {
    "type": "individual",
    "account_name": "Test Beneficiary",
    "state": "new  york",
    "city": "new  york",
    "address": "456 Elm Street",
    "post_code": "100001"
  }
}'
{
  "account_type": "checking",
  "account_number": "0123456789",
  "routing_number": "021000021",
  "bank_name": "Access Bank",
  "bank_address": "123 Main Street",
  "post_code": "10001",
  "city": "New York",
  "state": "New York",
  "country": "US",
  "beneficiary": {
    "type": "individual",
    "account_name": "Test Beneficiary",
    "state": "new  york",
    "city": "new  york",
    "address": "456 Elm Street",
    "post_code": "100001"
  }
}
alabama
alaska
american_samoa
arizona
arkansas
california
colorado
connecticut
delaware
district_of_columbia
florida
georgia
guam
hawaii
idaho
illinois
indiana
iowa
kansas
kentucky
louisiana
maine
maryland
massachusetts
michigan
minnesota
mississippi
missouri
montana
nebraska
nevada
new_hampshire
new_jersey
new_mexico
new_york
north_carolina
north_dakota
northern_mariana_islands
ohio
oklahoma
oregon
pennsylvania
puerto_rico
rhode_island
south_carolina
south_dakota
tennessee
texas
united_states_minor_outlying_islands
utah
vermont
virgin_islands_us
virginia
washington
west_virginia
wisconsin
wyoming

Admin API

Use these endpoints to retrieve wallet balances, transactions, deposits, and issued cards tied to the provided admin API keys.

Get Admin Balance

Retrieve the current funding, visa, and giftcard wallet balances for the authenticated admin account.

Endpoint: GET /api/admin/balance

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key
curl -X GET https://pagocards.com/api/admin/balance \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"
{
  "status": "success",
  "master_wallet_balance": 250.5,
  "visa_wallet_balance": 100.25,
  "giftcard_wallet_balance": 40
}

Get Admin Transactions

Retrieve paginated transactions for the authenticated admin account. Results can be filtered by transaction UUID and description text.

Endpoint: GET /api/admin/transactions

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key

Query Parameters:

  • page_number (optional): Page number (default: 1)
  • per_page (optional): Items per page (default: 20, max: 100)
  • uuid (optional): Exact match against the transaction uuid column
  • searchterm (optional): Partial match against the transaction description column
curl -X GET "https://pagocards.com/api/admin/transactions?page_number=1&per_page=20&uuid=0c3b2f4a-1111-2222-3333-444455556666&searchterm=funding" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"
{
  "status": "success",
  "total": 1,
  "per_page": 20,
  "current_page": 1,
  "total_pages": 1,
  "transactions": [
    {
      "uuid": "0c3b2f4a-1111-2222-3333-444455556666",
      "description": "Wallet funding",
      "amount": "50.00"
    }
  ]
}

Get Admin Deposits

Retrieve paginated deposit records for the authenticated admin account.

Endpoint: GET /api/admin/deposits

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key

Query Parameters:

  • page_number (optional): Page number (default: 1)
  • per_page (optional): Items per page (default: 15, max: 100)
curl -X GET "https://pagocards.com/api/admin/deposits?page_number=1&per_page=15" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY"
{
  "status": "success",
  "total": 1,
  "per_page": 15,
  "current_page": 1,
  "total_pages": 1,
  "deposits": [
    {
      "amount": "100.00",
      "status": "success"
    }
  ]
}

Get All Admin Cards

Retrieve issued cards associated with the authenticated admin API keys. Results can be filtered by brand.

Endpoint: POST /api/admin/allcards

Headers:

  • publickey (required): Your public API key
  • secretkey (required): Your secret API key

Request Body Parameters:

  • brand (optional): Filter by visa or master
  • per_page (optional): Number of cards per page (default: 15)
curl -X POST https://pagocards.com/api/admin/allcards \
-H "Content-Type: application/json" \
-H "publickey: YOUR_PUBLIC_KEY" \
-H "secretkey: YOUR_SECRET_KEY" \
-d '{
  "brand": "visa",
  "per_page": 20
}'
{
  "brand": "visa",
  "per_page": 20
}
{
  "status": "success",
  "message": "Cards retrieved successfully",
  "data": {
    "total": 1,
    "per_page": 20,
    "current_page": 1,
    "last_page": 1,
    "from": 1,
    "to": 1,
    "cards": [
      {
        "cardid": "card_123",
        "useremail": "joe@doe.com",
        "lastfour": "1234",
        "brand": "visa",
        "type": "virtual",
        "status": "active"
      }
    ]
  },
  "code": 200
}