Update Subscription

put/direct/subscription/{subscriptionid}

Request

  • Base URL
    https://api.ksamerchant.geidea.net/subscriptions/api/v1
  • URL
    https://api.ksamerchant.geidea.net/subscriptions/api/v1/direct/subscription/{subscriptionid}
  • Auth
    HTTP basic

Path parameters

subscriptionidstring required

The id that was generated on the creation of the subscription

Request body

Currencystring

The currency of the payment. This is a 3-digit alphabetic code, following the ISO 4217 currency code standard. For example: AED

recurringPaymentAmountnumber float

Subscription amount ex: 100.00

cycleInterval'day' | 'week' | 'month' | 'year'

Frequency for which a subscription transaction must be executed.

cycleFrequencyinteger

Number of times the subscription must be executed 1, 2, etc...

typeOfPayment'RecurringLink' | 'RecurringPayment'

Indicates type of Recurring Payment. RecurringPayment: means subsequent payment will be auto-collected from the customer based on his first payment RecurringLink: means a payment link will be sent to the customer based on the cycle interval and frequency. The customer needs to be present every time to pay If you are using Geidea Session or direct API's then you can pass typeOfPayment" = 'RecurringPayment"& "isFirstPmtPBL":false and collect the first payment from the customer via HPP. The subsequent payments will be auto-collected from the customer based on the scheduled job

customerIdstring

If you have already created a customer using the customerRequest object, you can pass it here. One of customerRequest Object or customerId is mandatory.

descriptionstring

The description of the subscription ex: TV channel plan A

startDatestring

Start date of subscription. Ex: "2024-03-05T09:26:07.472Z"

endDatestring

The end date of the subscription. For creating an endless subscription do not pass the endDate. For creating a subscription for a specific period, pass the endDate or numberOfPayments

numberOfPaymentsstring

The number of payments for the subscription. For creating an endless subscription do not pass the endDate. For creating a subscription for a specific period, pass the endDate or numberOfPayments

language'en' | 'ar'

The language to be used on the checkout page.

isFirstPmtPBLboolean

Use this parameter as with value true or false depending upon how you would like to collect the first payment. If you pass this as true the customer will receive the first payment request as a payment link. If you are using Geidea Session or direct API's please pass the value as false. Default value will be true

paylinkExpirationPeriodstring

The payment link expiration date, is required only when the isFirstPmtPBL parameter is set to true. The default expiration period for the payment link is 7 days. If you want to use any cycle frequency less than 7 days, please make sure you are passing the expiration period accordingly.

AmountVariability'VARIABLE' | 'FIXED'

Indicates whether the subscription amount is fixed or changing during the subscription. If value is "FIXED" then the amount does not change during the subscription. If the value is "VARIABLE" then amount can be changed for the subscription. Note: If "FIXED" is used then "currency", "recurringPaymentAmount" and "cycleFrequency" can't be updated

Response

200

object required

Changes

No recorded changes to this operation across all 1 revision of this API.