Skip to main content

💰 Payment Methods

UniPulse supports multiple payment providers to serve customers globally. Manage your cards, set defaults, and download invoices — all from Settings > Billing > Payment Methods.

Supported Providers​

ProviderRegionsPayment Types
StripeGlobalCredit cards, debit cards (Visa, Mastercard, Amex, etc.)
PaymobMiddle East & North Africa (MENA)Credit/debit cards, mobile wallets, local payment methods
KashierEgypt & MENACredit/debit cards, local payment methods

Your subscription's provider field records which processor handles your billing. The provider is selected automatically based on your region and payment method, or you can choose during checkout.

Payment Method Data​

Each saved payment method is stored securely:

FieldDescription
typeCard type (credit, debit, etc.)
lastFourEncLast four digits of the card (encrypted at rest)
brandEncCard brand — Visa, Mastercard, Amex, etc. (encrypted at rest)
expiryEncCard expiration date (encrypted at rest)
isDefaultWhether this is the default payment method for renewals
Behind the Scenes

UniPulse never stores full card numbers. Card data is tokenized by the payment provider (Stripe, Paymob, or Kashier) and only encrypted references (lastFourEnc, brandEnc, expiryEnc) are stored in the database. All sensitive data is encrypted at rest and in transit.

Managing Payment Methods​

Adding a Card​

  1. Go to Settings > Billing > Payment Methods
  2. Click Add Payment Method
  3. Enter your card details (processed securely by the payment provider)
  4. The card is tokenized and saved — full card numbers are never stored

Setting a Default​

  • Click the Set as Default button next to any saved card
  • The default card is used for all subscription renewals and upgrades
  • You must always have at least one default payment method while subscribed

Updating a Card​

  • If a card is expiring or has been replaced, add the new card and set it as default
  • Remove the old card once the new one is active

Removing a Card​

  • Click Remove next to any non-default card
  • You cannot remove your default payment method while you have an active subscription — set another card as default first

Failed Payments​

When a payment fails (e.g., expired card, insufficient funds):

  1. A Transaction with status FAILED is recorded
  2. Your subscription moves to PAST_DUE status
  3. You'll receive an email notification to update your payment method
  4. The system will retry the charge automatically over several days
  5. If retries continue to fail, the subscription becomes EXPIRED

To resolve: add a new card or update the existing one at Settings > Billing > Payment Methods, then the next retry will use the updated method.

Invoices​

Download invoices for any billing period:

  1. Go to Settings > Billing > Invoices
  2. Browse your invoice history (one per billing period)
  3. Click Download for a PDF invoice

Each invoice includes:

  • Invoice number and date
  • Plan name and billing period
  • Amount charged and currency
  • Payment method used (last four digits)
  • Transaction status

Billing Currency​

  • Default billing currency is USD
  • Regional pricing may be available depending on your location and payment provider
  • The currency field on your Subscription and Transactions records the actual currency used