Charge additional amount
Charge additional amount
Charge an additional amount to the subscription
POST
/
v0
/
subscriptions
/
{subscriptionIdOrNumber}
/
charge
curl --request POST \
--url https://api.fungies.io/v0/subscriptions/{subscriptionIdOrNumber}/charge \
--header 'Content-Type: application/json' \
--header 'x-fngs-public-key: <api-key>' \
--header 'x-fngs-secret-key: <api-key>' \
--data '{
"description": "<string>",
"items": [
{
"name": "Premium Plan",
"unitPrice": 10000,
"currency": "USD",
"quantity": 1,
"offerId": "123e4567-e89b-12d3-a456-426614174000",
"price": 8.988465674311579e+307,
"value": 8.988465674311579e+307
}
]
}'{
"status": "<string>",
"data": {
"payment": {
"object": "payment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "one_time",
"number": "<string>",
"status": "PENDING",
"value": 0,
"tax": 0,
"fee": 0,
"currency": null,
"currencyDecimals": null,
"createdAt": 4503599627370495,
"userId": null,
"user": null,
"orderId": null,
"orderNumber": null,
"order": null,
"subscriptionId": null,
"subscription": null,
"invoiceNumber": null,
"invoiceUrl": null
}
}
}Path Parameters
Subscription ID or order number
Body
application/json
POST /v0/subscriptions/:subscriptionIdOrNumber/charge Request body
Name of the Item. Required if Offer ID is not provided. Can be used to override the Offer name.
Example:
"Premium Plan"
New unit price in cents (min: 100). Required if Offer ID is not provided. Can be used to override the Offer price.
Required range:
100 < x <= 9007199254740991Example:
10000
Valid currency code. Required if value is provided. Required if Offer ID is not provided. Can be used to override the Offer currency.
Note: Currently needs to match Workspace currency.
Available options:
AFN, ALL, DZD, AOA, ARS, AMD, AWG, AUD, AZN, BSD, BDT, BBD, BZD, BMD, BOB, BAM, BWP, BRL, BHD, GBP, BND, BGN, BIF, BYN, KHR, CAD, CVE, KYD, KWD, XAF, XPF, CLP, CNY, COP, KMF, CDF, CRC, HRK, CZK, DKK, DJF, DOP, XCD, EGP, ETB, EUR, FKP, FJD, GMD, GEL, GIP, GTQ, GNF, GYD, HTG, HNL, HKD, HUF, ISK, INR, IDR, ILS, JMD, JPY, JOD, KZT, KES, KGS, LAK, LBP, LSL, LRD, MOP, MKD, MGA, MWK, MYR, MVR, MRO, MUR, MXN, MDL, MNT, MAD, MZN, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NGN, NOK, OMR, PKR, PAB, PGK, PYG, PEN, PHP, PLN, QAR, RON, RUB, RWF, SHP, SVC, WST, STD, SAR, RSD, SCR, SLL, SGD, SBD, SOS, ZAR, KRW, LKR, SRD, SZL, SEK, CHF, TJS, TZS, THB, TND, TOP, TTD, TRY, UGX, UAH, AED, UYU, USD, UZS, VUV, VEF, VND, XOF, YER, ZMW, SLE, XCG, SSP, VES, MRU, STN, VED Example:
"USD"
Optional quantity (default: 1).
Required range:
1 <= x <= 1.7976931348623157e+308Example:
1
Optional valid Offer ID. Adds Offer reference to the Item.
Note: name, value and currency are derived from the Offer if not provided.
- name: Offer name with full specification
- value: Offer price
- currency: Offer currency
Example:
"123e4567-e89b-12d3-a456-426614174000"
Deprecated. Use value instead.
Required range:
100 <= x <= 1.7976931348623157e+308Deprecated. Use unitPrice instead.
Required range:
100 <= x <= 1.7976931348623157e+308Response
200
application/json
POST /v0/subscriptions/:subscriptionIdOrNumber/charge Positive response
Allowed value:
"success"Available options:
one_time, subscription_initial, subscription_update, subscription_interval, subscription_extra, claim_free Available options:
PENDING, PAID, FAILED, UNPAID, CANCELLED, REFUNDED, PARTIALLY_REFUNDED, EXPIRED Required range:
0 <= x <= 9007199254740991Available options:
payment Required range:
-9007199254740991 <= x <= 9007199254740991Required range:
-9007199254740991 <= x <= 9007199254740991Required range:
-9007199254740991 <= x <= 9007199254740991Available options:
AFN, ALL, DZD, AOA, ARS, AMD, AWG, AUD, AZN, BSD, BDT, BBD, BZD, BMD, BOB, BAM, BWP, BRL, BHD, GBP, BND, BGN, BIF, BYN, KHR, CAD, CVE, KYD, KWD, XAF, XPF, CLP, CNY, COP, KMF, CDF, CRC, HRK, CZK, DKK, DJF, DOP, XCD, EGP, ETB, EUR, FKP, FJD, GMD, GEL, GIP, GTQ, GNF, GYD, HTG, HNL, HKD, HUF, ISK, INR, IDR, ILS, JMD, JPY, JOD, KZT, KES, KGS, LAK, LBP, LSL, LRD, MOP, MKD, MGA, MWK, MYR, MVR, MRO, MUR, MXN, MDL, MNT, MAD, MZN, MMK, NAD, NPR, ANG, TWD, NZD, NIO, NGN, NOK, OMR, PKR, PAB, PGK, PYG, PEN, PHP, PLN, QAR, RON, RUB, RWF, SHP, SVC, WST, STD, SAR, RSD, SCR, SLL, SGD, SBD, SOS, ZAR, KRW, LKR, SRD, SZL, SEK, CHF, TJS, TZS, THB, TND, TOP, TTD, TRY, UGX, UAH, AED, UYU, USD, UZS, VUV, VEF, VND, XOF, YER, ZMW, SLE, XCG, SSP, VES, MRU, STN, VED Required range:
-9007199254740991 <= x <= 9007199254740991Available options:
PENDING, PAID, FAILED, UNPAID, CANCELLED, REFUNDED, PARTIALLY_REFUNDED, EXPIRED Available options:
order Available options:
all, active, canceled, incomplete, incomplete_expired, past_due, trialing, paused, unpaid Available options:
subscription curl --request POST \
--url https://api.fungies.io/v0/subscriptions/{subscriptionIdOrNumber}/charge \
--header 'Content-Type: application/json' \
--header 'x-fngs-public-key: <api-key>' \
--header 'x-fngs-secret-key: <api-key>' \
--data '{
"description": "<string>",
"items": [
{
"name": "Premium Plan",
"unitPrice": 10000,
"currency": "USD",
"quantity": 1,
"offerId": "123e4567-e89b-12d3-a456-426614174000",
"price": 8.988465674311579e+307,
"value": 8.988465674311579e+307
}
]
}'{
"status": "<string>",
"data": {
"payment": {
"object": "payment",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "one_time",
"number": "<string>",
"status": "PENDING",
"value": 0,
"tax": 0,
"fee": 0,
"currency": null,
"currencyDecimals": null,
"createdAt": 4503599627370495,
"userId": null,
"user": null,
"orderId": null,
"orderNumber": null,
"order": null,
"subscriptionId": null,
"subscription": null,
"invoiceNumber": null,
"invoiceUrl": null
}
}
}