Recurring Payments
The recurring Payments method gives a possibility to store a customer’s data and to perform a payment without a customer’s interaction.
To perform a Recurring Payment an order_id
from a successfully performed payment transaction is needed.
An order_id
can be received after at least the 0.10 GEL payment is successfully performed and then returned back. This order_id
can be further used in a future Recurring Payments
In most cases, the Payment Status will be in_progress
. To receive a current status the Payment Details method should be used.
note
By default, the feature of Recurring Payments is switched off. A Bank of Georgia should be contacted to activate this feature.
Parameters
order_idrequiredstring
An identifier of a successful payment performed by a given customer.
amountrequiredobject
A Payment Amount object.currency_coderequired
valuerequired
currency_coderequiredGEL
A payment currency.
valuerequirednumber
A Payment Amount value.
shop_order_idoptionalstring
A Payment identifier from an Online Shop system (i.e.: An identifier of a shopping Basket).
- REQUEST
POST /api/v1/checkout/payment/subscription
Content-Type: application/json
Authorization: Bearer <jwt_token>
{
"order_id": "<order_id>",
"amount": {
"currency_code": "GEL",
"value": "16.45"
},
"shop_order_id": "your_shop_order_id",
"purchase_description": "test_product"
}
Response
statusrequiredstring
A status of a Recurring Payment.
success
- A Recurring payment is successful.error
- A Recurring payment is unsuccessful.in_progress
- A Recurring payment is in progress. When this status is returned, a Payment Details method should be used to retrieve a payment status.
payment_hashoptionalstring
A payment_hash of a Recurring payment.
order_idoptionalstring
An ID of a Recurring payment.
- RESPONSE
{
"status": "success",
"payment_hash": "<payment_hash>",
"order_id": "<order_id>"
}