Skip to main content

​
Create payment

POST /paiement/{provider}
Permission: Connected + API
​
provider
string
required
Payment provider identifier (e.g., payviox, mannco)
Initiates a payment deposit to add balance to the user’s account through a payment provider.

​
Body Parameters

​
amount
integer
required
Amount to deposit in cents (minimum varies by provider, typically 500 = $5)
​
currency
string
default:"USD"
Currency code (USD, EUR, etc.)
​
returnUrl
string
URL to redirect to after payment completion
​
method
string
Specific payment method (credit_card, paypal, crypto, etc.) - varies by provider

​
Request Example

{
  "amount": 10000,
  "currency": "USD",
  "returnUrl": "https://yourapp.com/payment/success",
  "method": "credit_card"
}

​
Response

Success
{
  "err": false,
  "success": true,
  "content": {
    "paymentId": "PAY_123456789",
    "provider": "payviox",
    "amount": 10000,
    "currency": "USD",
    "status": "pending",
    "paymentUrl": "https://payment-provider.com/checkout/xyz123",
    "expiresAt": "1706835600"
  }
}

​
Response Fields

FieldTypeDescription
paymentIdstringUnique payment transaction ID
providerstringPayment provider name
amountintegerDeposit amount in cents
currencystringCurrency code
statusstringPayment status (pending, completed, failed)
paymentUrlstringURL to complete payment (redirect user here)
expiresAtstringUnix timestamp when payment link expires

​
Error Responses

StatusMessageDescription
errorInvalid amountAmount is below minimum or exceeds maximum
errorInvalid providerUnknown or unsupported payment provider
errorProvider unavailablePayment provider is temporarily unavailable
errorInvalid currencyCurrency not supported by provider
errorRate limit exceededToo many payment requests in short period

​
Supported Providers

ProviderMethodsMin/MaxProcessing Time
payvioxCredit Card, PayPal5−5 - 500Instant
manncoVarious10−10 - 1000Instant
After creating a payment, redirect the user to the paymentUrl to complete the transaction. The system will automatically credit the balance once payment is confirmed via webhook.

​
Payment Flow

  1. Create Payment: Client calls POST /paiement/{provider} with amount and details
  2. Redirect: User is redirected to paymentUrl to complete payment
  3. Process: User completes payment on provider’s site
  4. Webhook: Provider sends webhook to Mannco.store confirming payment
  5. Credit Balance: Balance is automatically added to user’s account
  6. Notification: User receives confirmation email and notification

​
Payment Status

StatusDescription
pendingPayment created, awaiting completion
processingPayment being verified by provider
completedPayment successful, balance credited
failedPayment failed or was cancelled
expiredPayment link expired without completion
Payment links typically expire after 1 hour. Users must complete the payment before expiration.
All payments are processed securely through our payment partners. Mannco.store does not store credit card information.

​
Testing Payments

For testing in sandbox/development environments, providers may offer test credentials and card numbers. Consult the specific provider’s documentation for test mode details.