# Automatic Payment API

The Automatic Payment API (version 1.0) by Khipu allows merchants to set up recurring payment  subscriptions using bank debits (PAC). Through the POST /v1/automatic-payment/subscription  endpoint, merchants submit details such as the subscription name, customer email, maximum  amount, currency, and URLs for notification, return, or cancellation. Upon success, the API  returns a unique subscription_id and a redirect_url where the user can authorize the debit  mandate with their bank. Merchants can later query and manage the PAC status using additional  endpoints. Authentication is handled via the x-api-key header.

Version: v1.0
License: Khipu Automatic Payment API

## Servers

Production
```
https://payment-api.khipu.com
```

## Security

### Api-Key

Type: apiKey
In: header
Name: x-api-key

## Download OpenAPI description

[Automatic Payment API](https://docs.khipu.com/_spec/@l10n/en/apis/v1/automatic-payments/openapi.yaml)

## Other

### Subscription creation

 - [POST /v1/automatic-payment/subscription](https://docs.khipu.com/en/apis/v1/automatic-payments/openapi/other/createsubscription_1.md): This method creates a new subscription.

### Subscription status

 - [GET /v1/automatic-payment/subscription/{id}](https://docs.khipu.com/en/apis/v1/automatic-payments/openapi/other/fetchsubscriptionstatus_1.md): This method get the current state of a automatic payment subscription.

### Charge intent creation

 - [POST /v1/automatic-payment/charge-intent](https://docs.khipu.com/en/apis/v1/automatic-payments/openapi/other/createcharge_1.md): This method creates a new charge request for the specified subscription.