API Store overview - PapelShip Developers

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" }'