API Store overview

This section is for API-based stores: stores you opened as an API Store in PapelShip to take payments from your own website, bot or app. If you run a regular PapelShip storefront (Digital Store), see the Digital Store tab instead.

The API Store lets any website or bot take payments through PapelShip. Pick the flow that fits your checkout.

Hosted payment links

PapelShip hosts the checkout. Your customer picks a method: credit card, Papara, bank transfer, or crypto.

Direct crypto invoices

You build the checkout. PapelShip gives you a unique deposit address, the exact crypto amount, and a QR code.

Payment lifecycle

Create an invoice with payment links or a crypto invoice.
The customer pays on the hosted checkout or to the deposit address.
Poll the status endpoint until is_paid is true.
Fulfill the order. Issue refunds when needed.

Supported currencies

Fiat amounts accept USD, EUR, TRY, and GBP. Crypto invoices support these coins:

Coin	Symbol	Coin	Symbol
Bitcoin	`BTC`	Tether	`USDT`
Litecoin	`LTC`	USD Coin	`USDC`
Ethereum	`ETH`	Solana	`SOL`
Dogecoin	`DOGE`	BNB	`BNB`
Tron	`TRX`

Refunds

Refund a completed invoice fully, or partially with amount_cents:

curl -X POST https://app.papelship.com/api/api-store/v1/refunds \
  -H "Authorization: Bearer psa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "invoice_id": "aB9xK12Lp9012345678901234", "amount_cents": 1000, "reason": "Customer requested cancellation" }'

Guides

Endpoints

Hosted payment links

Direct crypto invoices

Payment lifecycle

Supported currencies

Refunds

Hosted payment links

Direct crypto invoices

​Payment lifecycle

​Supported currencies

​Refunds

Payment lifecycle

Supported currencies

Refunds