Проведение оплаты с автоматическими списаниями

Повторяемая оплата с автоматическими списаниями — это тип платежа, в рамках которого на основании одного исходного запроса осуществляется серия регулярных переводов денежных средств от пользователя к мерчанту с использованием сохранённых платёжных данных и без подтверждения подлинности платёжного инструмента пользователя (такого, как ввод кода проверки подлинности карты).

В рамках платёжной платформы повторяемые оплаты с автоматическими списаниями проводятся в соответствии с моделью проведения платежей (подробнее).

В случаях, когда автоматическое списание в рамках регулярной оплаты отклоняется, например при недостатке средств на карте пользователя, в платёжной платформе ecommpay могут автоматически инициироваться повторные попытки выполнить такое списание спустя заданное время. Эта возможность подключается по согласованию с курирующим менеджером ecommpay и применяется, если она подключена для используемого проекта и при этом соблюдаются два условия:

• целевая оплата проводится с прямым использованием платёжной карты,
• списание отклонено на стороне платёжной системы или эмитента.

В других случаях при отклонении очередного списания в платформе ожидается следующее (согласно графику) и решения относительно необходимости дополнительных списаний или завершения серии списаний в целом должны приниматься на стороне мерчанта.

При использовании повторных попыток их количество и время на выполнение ограничиваются: для каждого очередного списания допускается не более 7 повторных попыток, которые могут быть выполнены в течение 6 суток. Интервал между первой (исходной) попыткой очередного списания и первой повторной попыткой, а также между первой и второй повторными попытками составляет 12 часов, интервал между остальными попытками — 24 часа. При этом проверяется, что до следующего очередного списания (согласно графику списаний) остаётся не менее 12,5 или 24,5 часов соответственно. Иначе повторные попытки прекращаются. Эти ограничения действуют для всех платежей в рамках любого проекта и не могут быть изменены.

Технически повторные попытки списаний выполняются следующим образом:

1. При отклонении очередного списания со стороны платёжной системы или эмитента в платёжной платформе ecommpay проверяется возможность повторить попытку, и если эта возможность подтверждается, то к веб-сервису направляется оповещение об отклонении списания со статусом операции decline и с плановыми датой и временем повторной попытки.
2. В заданное время автоматически выполняется повторная попытка списания.
3. Исходя из результата повторной попытки выполняются последующие действия:
   • Если попытка приводит к переводу необходимых средств от пользователя к мерчанту, то к веб-сервису направляется оповещение о результате списания (со статусом операции success) и оплата проводится дальше согласно графику.
   • Если попытка отклоняется и в платёжной платформе подтверждается возможность выполнить следующую попытку, то к веб-сервису направляется повторное оповещение об отклонении списания (со статусом операции decline и с плановыми датой и временем следующей попытки) и шаг 2 повторяется.
   • Если попытка отклоняется и в платёжной платформе не подтверждается возможность выполнить следующую попытку, то к веб-сервису направляется итоговое оповещение об отклонении списания (со статусом операции decline и без информации о следующей попытке) и оплата проводится дальше согласно графику. В таком случае решения относительно необходимости дополнительных списаний или завершения серии списаний и оплаты в целом должны приниматься на стороне мерчанта.

Вместе с тем, повторныеПовторные попытки списаний могут быть прекращены даже после того, как были запланированы — с помощью соответствующих программных запросов через Gate или инструментов интерфейса Dashboard, а также при изменении свойств повторяемой оплаты (в том числе при истечении срока её действия или отмене, что ведёт к изменению статуса платежа в целом и к отмене дальнейших списаний по нему). Кроме того, при необходимости всегда можно обращаться к специалистам технической поддержки ecommpay.

От платёжной платформы к веб-сервису передаются оповещения с информацией о результате каждого списания в рамках повторяемой оплаты. Для этих оповещений используется типовой формат, описание которого представлено в разделе Оповещения.

В случае, если подключена возможность повторных попыток списаний, в таких оповещениях также содержится объект recurring_retry, в который могут включаться следующие параметры:

• trigger_operation_id — идентификатор очередного списания, для которого была выполнена повторная попытка.
• retry_count — номер повторной попытки (число от 1 до 7), если такая попытка была выполнена.
• next_retry_exists — индикатор наличия следующей запланированной попытки.

  Этот параметр принимает значение true, если списание средств не было выполнено и возможность повторить попытку списания доступна (количество попыток и время на их выполнение не исчерпаны), и значение false во всех остальных случаях.

• next_retry_date — дата и время следующей запланированной попытки.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 42 для пользователя customer_12 было выполнено списание в размере 4,00 USD с платёжной карты № 424242******4243 и ожидаются последующие списания. Возможность повторных попыток списаний не подключена.

{  
  "customer":{  
    "id":"customer_12"
  },
  "account":{  
    "number":"431422******0056",
    "type":"visa",
    "card_holder":"JOHN SMITH",
    "id":45678,
    "expiry_month":"08",
    "expiry_year":"2026"
  },
  "payment":{  
    "sum":{  
      "amount":400,
      "currency":"USD"
    },
    "method":"card",
    "date":"2023-06-07T06:18:02+0000",
    "status":"scheduled recurring processing",    // Статус платежа
    "type":"recurring",    // Тип платежа
    "id":"456789",
    "description":""
  },
  "project_id":42,
  "recurring":{  
    "valid_thru":"2023-07-31T00:00:00+0000",
    "currency":"USD",
    "id":1079    // Идентификатор серии списаний
  },
  "operation":{  
    "id":39690002636,
    "type":"recurring",    // Тип операции
    "status":"success",    // Статус операции
    "date":"2023-06-07T06:18:02+0000",
    "created_date":"2023-06-07T06:18:02+0000",
    "request_id":"5cfa0199c33071",
    "sum_initial":{  
      "amount":400,
      "currency":"USD"
    },
    "sum_converted":{  
      "amount":400,
      "currency":"USD"
    },
    "provider":{  
      "id":6,
      "payment_id":"1192",
      "date":"2023-02-07T08:34:24+0000",
      "auth_code":"5253",
      "endpoint_id":6
    },
    "code":"0",
    "message":"Success"
  },
  "signature":"v7KNMpfZZ5D/aZMdeR+YyilUwSm...=="
}

В следующем примере содержится информация о том, что для отклонённого списания запланирована первая повторная попытка выполнить это списание ("next_retry_exists : true"). В этом случае не указываются идентификатор целевого списания и идентификатор повторной попытки, поскольку ни одна повторная попытка ещё не выполнялась.

"recurring_retry": {   
            "next_retry_exists": true,
            "next_retry_date": "2023-05-24T16:58:02+0000"  
            }

В следующем примере содержится информация о том, что в результате первой повторной попытки ("retry_count": 1) списание 344589675 было отклонено, и для этого списания запланирована вторая повторная попытка ("next_retry_exists" : true) на 2023-05-24T16:58:02+0000.

"recurring_retry": {   
            "trigger_operation_id": 344589675,
            "retry_count": 1,
            "next_retry_exists": true,
            "next_retry_date": "2023-05-24T16:58:02+0000"  
            }

В следующем примере содержится информация о том, что в результате второй повторной попытки ("retry_count": 2) списание 344589675 было выполнено (привело к переводу средств от пользователя к мерчанту), и для этого списания больше не требуются повторные попытки ("next_retry_exists" : false).

"recurring_retry": {     
            "trigger_operation_id": 344589675,
            "next_retry_exists": false,
            "retry_count": 2
            }

В следующем примере содержится информация о том, что для одного из списаний в рамках повторяемой оплаты не выполнялось и не планируется ни одной повторной попытки. Оповещения с такой информацией могут отправляться, когда списание привело к переводу средств с первой (исходной) попытки или повторные попытки не могут выполняться.

"recurring_retry": {   
            "next_retry_exists": false 
            }