Namirasoft Payment API V1
Namira Software Corporation Payment API Version 1 (1.4.37)
Install
To use this cli, we need to first Install Nodejs, then run the following command.
npm i -g namirasoft-payment-api-v1
Copied!
Commands
Healthz
Get
Returns the application health status
ns-payment healthz get
Copied!
Value
List
Returns the value list of a given table and column
ns-payment value list {table} {column} {search} {field_id} {limit}
Copied!
Invoice
List
Returns the invoice list
ns-payment invoice list {filters} {page} {size} {sorts}
Copied!
Get
Returns an invoice by an id
ns-payment invoice get {id}
Copied!
_Create
Creates a new invoice
ns-payment invoice _create
Copied!
--stripe_invoice_id (String)
--product_id (String)
--transaction_id (String)
--subscription_id (String)
--title (String)
--refund (Boolean)
--currency (String)
--description (String)
--invoice_items (Array)
--invoice_costs (Array)
_Delete
Deletes an invoice by an id
ns-payment invoice _delete {id}
Copied!
Cancel
Cancels an invoice by an id
ns-payment invoice cancel {id}
Copied!
Offer
List
Returns the offer list
ns-payment offer list {filters} {page} {size} {sorts}
Copied!
Get
Returns an offer by an id
ns-payment offer get {id}
Copied!
OneTime
Checkout
Creates a onetime checkout
ns-payment onetime checkout {invoice_id}
Copied!
--gateway (Enum)
--amount (Integer)
--success_url (String)
--cancel_url (String)
Payment
List
Returns the payment list
ns-payment payment list {filters} {page} {size} {sorts}
Copied!
Get
Returns a payment by an id
ns-payment payment get {id}
Copied!
SalesItem
List
Returns the sales item list
ns-payment salesitem list {filters} {page} {size} {sorts}
Copied!
Get
Returns a sales item by an id
ns-payment salesitem get {id}
Copied!
SubscriptionPaid
List
Returns the subscription paid list
ns-payment subscriptionpaid list {filters} {page} {size} {sorts}
Copied!
Get
Returns a subscription paid by an id
ns-payment subscriptionpaid get {id}
Copied!
_ListFor
Returns the subscription paid list for a user_id
ns-payment subscriptionpaid _listfor {user_id} {sales_item_id}
Copied!
Subscription
List
Returns the subscription list
ns-payment subscription list {filters} {page} {size} {sorts}
Copied!
Get
Returns a subscription by an id
ns-payment subscription get {id}
Copied!
Cancel
Cancels a subscription by an id
ns-payment subscription cancel {id} {reason}
Copied!
Checkout
Checkouts to a subscription
ns-payment subscription checkout
Copied!
--gateway (Enum)
--sales_item_id (String)
--offer_id (String)
--success_url (String)
--cancel_url (String)
Product
List
Returns the product list
ns-payment product list {filters} {page} {size} {sorts}
Copied!
Get
Returns a product by an id
ns-payment product get {id}
Copied!
Schemas
Invoice
{ "name": "Invoice", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_invoice_id": { "type": "String", "required": true, "max": 255 }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "transaction_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "subscription_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "title": { "type": "String", "required": true, "max": 255 }, "refund": { "type": "Boolean", "required": true }, "canceled": { "type": "Boolean", "required": true }, "currency": { "type": "String", "required": true, "max": 255 }, "total": { "type": "Integer", "required": true }, "total_cost": { "type": "Integer", "required": true }, "total_payable": { "type": "Integer", "required": true }, "total_paid": { "type": "Integer", "required": true }, "total_refunded": { "type": "Integer", "required": true }, "total_balance": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
InvoiceFull
{ "name": "InvoiceFull", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_invoice_id": { "type": "String", "required": true, "max": 255 }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "transaction_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "subscription_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "title": { "type": "String", "required": true, "max": 255 }, "refund": { "type": "Boolean", "required": true }, "canceled": { "type": "Boolean", "required": true }, "currency": { "type": "String", "required": true, "max": 255 }, "total": { "type": "Integer", "required": true }, "total_cost": { "type": "Integer", "required": true }, "total_payable": { "type": "Integer", "required": true }, "total_paid": { "type": "Integer", "required": true }, "total_refunded": { "type": "Integer", "required": true }, "total_balance": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true }, "invoice_items": { "type": "Array", "required": true, "items": [ { "name": "InvoiceItemInput", "type": "Object", "required": true, "fields": { "sales_item_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "name": { "type": "String", "required": true, "max": 255 }, "quantity": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "price": { "type": "Integer", "required": false } } } ] }, "invoice_costs": { "type": "Array", "required": true, "items": [ { "name": "InvoiceCostInput", "type": "Object", "required": true, "fields": { "type": { "name": "InvoiceCostType", "type": "Enum", "required": false, "valids": [ "Discount", "Tax" ] }, "amount": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false } } } ] }, "total_tax": { "type": "Integer", "required": true }, "total_discount": { "type": "Integer", "required": true } }}
InvoiceItemInput
{ "name": "InvoiceItemInput", "type": "Object", "required": true, "fields": { "sales_item_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "name": { "type": "String", "required": true, "max": 255 }, "quantity": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "price": { "type": "Integer", "required": false } }}
InvoiceCostInput
{ "name": "InvoiceCostInput", "type": "Object", "required": true, "fields": { "type": { "name": "InvoiceCostType", "type": "Enum", "required": false, "valids": [ "Discount", "Tax" ] }, "amount": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false } }}
InvoiceInput
{ "name": "InvoiceInput", "type": "Object", "required": true, "fields": { "stripe_invoice_id": { "type": "String", "required": true, "max": 255 }, "product_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "transaction_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "subscription_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "title": { "type": "String", "required": true, "max": 255 }, "refund": { "type": "Boolean", "required": true }, "currency": { "type": "String", "required": true, "max": 255 }, "description": { "type": "String", "required": false }, "invoice_items": { "type": "Array", "required": true, "items": [ { "name": "InvoiceItemInput", "type": "Object", "required": true, "fields": { "sales_item_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "name": { "type": "String", "required": true, "max": 255 }, "quantity": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "price": { "type": "Integer", "required": false } } } ] }, "invoice_costs": { "type": "Array", "required": true, "items": [ { "name": "InvoiceCostInput", "type": "Object", "required": true, "fields": { "type": { "name": "InvoiceCostType", "type": "Enum", "required": false, "valids": [ "Discount", "Tax" ] }, "amount": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false } } } ] } }}
Offer
{ "name": "Offer", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_price_id": { "type": "String", "required": true, "max": 255 }, "product_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "sales_item_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "name": { "type": "String", "required": true, "max": 255 }, "logo": { "type": "String", "required": false, "max": 255 }, "order": { "type": "Integer", "required": true }, "subscription_duration_unit": { "name": "OfferSubscriptionDurationUnit", "type": "Enum", "required": true, "valids": [ "Day", "Week", "Month", "Year" ] }, "subscription_duration_value": { "type": "Integer", "required": true }, "applies_at": { "type": "DateTime", "required": false }, "expires_at": { "type": "DateTime", "required": false }, "currency": { "type": "String", "required": false, "max": 255 }, "orginal_price": { "type": "Float", "required": false }, "final_price": { "type": "Float", "required": false }, "recommended": { "type": "Boolean", "required": true }, "description": { "type": "String", "required": true }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
Payment
{ "name": "Payment", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_payment_id": { "type": "String", "required": true, "max": 255 }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "transaction_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "invoice_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "subscription_id": { "type": "String", "required": false, "min": 20, "max": 20 }, "gateway": { "name": "PaymentGateway", "type": "Enum", "required": true, "valids": [ "Stripe" ] }, "refund": { "type": "Boolean", "required": true }, "status": { "name": "PaymentStatus", "type": "Enum", "required": true, "valids": [ "Incomplete", "Canceled", "Succeeded", "Failed" ] }, "currency": { "type": "String", "required": true, "max": 255 }, "amount": { "type": "Integer", "required": true }, "description": { "type": "String", "required": false }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
SalesItem
{ "name": "SalesItem", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "name": { "type": "String", "required": true, "max": 255 }, "slug": { "type": "String", "required": true, "max": 255 }, "logo": { "type": "String", "required": true, "max": 255 }, "method": { "name": "SalesItemMethod", "type": "Enum", "required": true, "valids": [ "OneTime", "Subscription", "Metered" ] }, "onetime_consumable": { "type": "Boolean", "required": false }, "onetime_expire_unit": { "name": "SalesItemOnetimeExpireUnit", "type": "Enum", "required": false, "valids": [ "None", "Day", "Week", "Month", "Year" ] }, "onetime_expire_value": { "type": "Integer", "required": false }, "onetime_limit_unit": { "name": "SalesItemOnetimeLimitUnit", "type": "Enum", "required": false, "valids": [ "None", "Day", "Week", "Month", "Year" ] }, "onetime_limit_value": { "type": "Integer", "required": false }, "onetime_limit_count": { "type": "String", "required": false, "max": 255 }, "currency": { "type": "String", "required": false, "max": 255 }, "orginal_price": { "type": "Float", "required": false }, "final_price": { "type": "Float", "required": false }, "description": { "type": "String", "required": true }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
SubscriptionPaid
{ "name": "SubscriptionPaid", "type": "Object", "required": true, "fields": { "id": { "type": "Integer", "required": true }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "invoice_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "sales_item_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "applies_at": { "type": "DateTime", "required": true }, "expires_at": { "type": "DateTime", "required": true }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
Subscription
{ "name": "Subscription", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_subscription_id": { "type": "String", "required": true, "max": 255 }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "gateway": { "name": "SubscriptionGateway", "type": "Enum", "required": true, "valids": [ "Stripe" ] }, "status": { "name": "SubscriptionStatus", "type": "Enum", "required": true, "valids": [ "Active", "Canceled", "Incomplete", "IncompleteExpired", "PastDue", "Paused", "Trialing", "Unpaid" ] }, "reason": { "type": "String", "required": false, "max": 255 }, "description": { "type": "String", "required": true }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
SubscrpitionFull
{ "name": "SubscrpitionFull", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "min": 20, "max": 20 }, "stripe_subscription_id": { "type": "String", "required": true, "max": 255 }, "user_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "product_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "offer_id": { "type": "String", "required": true, "min": 20, "max": 20 }, "gateway": { "name": "SubscriptionGateway", "type": "Enum", "required": true, "valids": [ "Stripe" ] }, "status": { "name": "SubscriptionStatus", "type": "Enum", "required": true, "valids": [ "Active", "Canceled", "Incomplete", "IncompleteExpired", "PastDue", "Paused", "Trialing", "Unpaid" ] }, "reason": { "type": "String", "required": false, "max": 255 }, "description": { "type": "String", "required": true }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
Product
{ "name": "Product", "type": "Object", "required": true, "fields": { "id": { "type": "String", "required": true, "max": 255 }, "name": { "type": "String", "required": true, "max": 255 }, "slug": { "type": "String", "required": true, "max": 255 }, "logo": { "type": "String", "required": true, "max": 255 }, "description": { "type": "String", "required": false }, "created_at": { "type": "DateTime", "required": true }, "updated_at": { "type": "DateTime", "required": true } }}
Enums
InvoiceCostType
Discount
Tax
OfferSubscriptionDurationUnit
Day
Week
Month
Year
GatewayType
Stripe
PaymentGateway
Stripe
PaymentStatus
Incomplete
Canceled
Succeeded
Failed
SalesItemMethod
OneTime
Subscription
Metered
SalesItemOnetimeExpireUnit
None
Day
Week
Month
Year
SalesItemOnetimeLimitUnit
None
Day
Week
Month
Year
SubscriptionGateway
Stripe
SubscriptionStatus
Active
Canceled
Incomplete
IncompleteExpired
PastDue
Paused
Trialing
Unpaid
Namira Software Corporation
©Copyright 2010 to 2025 Namira Software Corporation. All rights reserved.