Выплаты на банковские счета в Сингапуре

Введение

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

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

Характеристика

Схема работы

В проведении отдельного платежа с использованием метода «Выплаты на банковские счета в Сингапуре» задействуются веб-сервис мерчанта, один из интерфейсов и платёжная платформа ecommpay, а также технические средства сервиса провайдера.

Основные операции

Для проведения платежей и выполнения операций с использованием метода «Выплаты на банковские счета в Сингапуре» могут применяться различные интерфейсы платёжной платформы. Так, выплаты могут проводиться через Gate и Dashboard. При этом, независимо от используемых интерфейсов, для этого метода характерны следующие свойства и ограничения.

При работе с методом «Выплаты на банковские счета в Сингапуре», независимо от используемых интерфейсов, актуальны следующие свойства и ограничения.

Сценарии использования

Проведение выплат с использованием метода «Выплаты на банковские счета в Сингапуре» осуществляется с уведомлением пользователей через веб-сервис мерчанта.

Вместе с тем, к особенностям работы с методом «Выплаты на банковские счета в Сингапуре» можно отнести то, что выплаты могут проводиться на банковские счета непосредственно через банки либо через другие организации, предоставляющие финансовые услуги в Сингапуре. Таким образом, для каждой выплаты с использованием этого метода должен быть указан конкретный банк (или конкретная организация). При работе через Gate для этого должны использоваться соответствующие идентификаторы, работа с которыми описана в следующем подразделе, Поддержка со стороны банков и других организаций.

Поддержка со стороны банков и других организаций

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

Поскольку со временем состав доступных банков и организаций может меняться, для получения актуальной информации рекомендуется использовать POST-запрос к конечной точке /v2/info/banks/singapore/payout/list, которая относится к группе конечных точек /v2/info/banks/{payment_method}/{operationType}/list Gate API. В этом запросе должны указываться идентификатор проекта, а также идентификатор, валюта и сумма платежа и подпись к этим данным; при этом рекомендуется передавать реальные данные о платеже, но допускается и указание произвольных значений.

{
    "general": {
        "project_id": 200,
        "payment_id": "ORDER_155860015",
        "signature": "K6jllym+PtObocZtr345st...=="
    },
    "payment": {
        "amount": 10000,
        "currency": "SGD"
    }
}

С вопросами о работе с банками и другими организациями, поддерживающими метод «Выплаты на банковские счета в Сингапуре», можно обращаться к курирующему менеджеру ecommpay.

Общая информация

Для проведения выплаты через Gate с использованием метода «Выплаты на банковские счета в Сингапуре» со стороны веб-сервиса необходимо отправить запрос, содержащий требуемые параметры и подпись, на рабочий URL ecommpay и принять оповещение о результате. Полная схема проведения выплаты выглядит следующим образом.

Информация о форматах запросов и оповещений, используемых для проведения выплат методом «Выплаты на банковские счета в Сингапуре» через Gate, приведена далее в этом разделе; общая информация о работе с Gate API — в отдельной статье Организация взаимодействия.

Формат запросов

При работе с запросами на выплаты с применением метода «Выплаты на банковские счета в Сингапуре» необходимо учитывать следующее:

1. Для инициирования каждой выплаты должен использоваться отдельный POST-запрос к конечной точке /v2/payment/banks/singapore/payout. Эта точка относится к группе /v2/payment/banks/{payment_method}/payout.
2. В каждом запросе должны использоваться следующие объекты и параметры:
   • general — объект, содержащий основные идентификационные сведения запроса:
     • project_id — идентификатор проекта, полученный от ecommpay при интеграции;,
     • payment_id — идентификатор платежа, уникальный в рамках проекта;,
     • signature — подпись запроса, составленная после указания всех целевых параметров (подробнее — в статье Работа с подписью к данным); (подробнее),
   • payment — объект, содержащий сведения о платеже:
     • amount — сумма выплаты в дробных единицах валюты;,
     • currency — буквенный код валюты платежа в формате ISO-4217 alpha-3;,
   • customer — объект, содержащий сведения о получателе выплаты (пользователе):
     • id — идентификатор получателя, уникальный в рамках проекта;,
     • ip_address — IP-адрес получателя, актуальный для инициируемой выплаты;,
   • account — объект, содержащий сведения о счёте получателя выплаты:
     • number — номер банковского счёта получателя (без указания дефисов и иных разделительных символов).
3. Необходимо передавать полное имя владельца банковского счёта в одном из двух следующих объектов (на выбор мерчанта) со всеми указанными для этого объекта параметрами:
   • customer — объект, содержащий сведения о получателе выплаты (пользователе):
     • first_name — имя владельца счёта;,
     • last_name — фамилия владельца счёта;,
   • account — объект, содержащий сведения о счёте получателя:
     • customer_name — полное имя владельца счёта.
4. Необходимо указывать сведения о банке (или другой организации, через которую проводится выплата на счёт получателя) в одном из двух параметров объекта account (на выбор мерчанта):
   • bank_id — идентификатор банка (или другой организации, через которую проводится выплата), используемый в платёжной платформе ecommpay;
   • bank_code — международный идентификационный код (БИК или SWIFT) банка или другой организации, через которую проводится выплата.
5. Валютой платежа может быть только SGD.
6. Дополнительно могут использоваться любые другие параметры из числа указанных в спецификации.

Таким образом, корректный запрос на выплату с применением метода «Выплаты на банковские счета в Сингапуре» должен содержать идентификатор проекта, базовые сведения о платеже (идентификатор, сумму и код валюты), сведения о получателе (идентификатор и IP-адрес), сведения о банке или другой организации, через которую проводится выплата, сведения о счёте получателя, включая полное имя владельца этого счёта, и подпись, а также может содержать различные дополнительные параметры.

{
  "general": {
    "project_id": 567890,
    "payment_id": "test1234567890",
    "signature": "PJkV8ej\/UG0Di8hTng6JvipTv+AWoXW\/9MTO8yJA=="
  },
  "payment": {
    "amount": 12300,
    "currency": "SGD"
  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0"
  },
  "account": {
    "bank_id": "57001",
    "customer_name": "John Doe",
    "number": "0788883332"
  }
}

  },
  "customer": {
    "id": "customer123",
    "ip_address": "192.0.2.0",
    "first_name": "John",
    "last_name": "Doe"
  },
  "account": {
    "bank_id": "57001",
    "number": "0788883332"
  }
}

  },
  "account": {
    "bank_code": "DBSSSGSGXXX",
    "customer_name": "John Doe",
    "number": "0788883332"
  }
}

Формат итоговых оповещений

Для оповещений о результатах выплат с применением метода «Выплаты на банковские счета в Сингапуре» используется типовой формат, описание которого представлено в статье Работа с оповещениями.

В следующем примере оповещение свидетельствует о том, что в рамках проекта 12345 для пользователя customer123 была проведена выплата в размере 123,00 SGD.

 {
        "project_id": 12345,
        "payment": {
            "id": "payment4444",
            "type": "payout",
            "status": "success",
            "date": "2025-09-12T13:28:58+0000",
            "method": "Singapore Banks",
            "sum": {
                "amount": 12300,
                "currency": "SGD"
            },
            "description": "payout"
        },
        "account": {
            "number": "12-34-******5-67"
        },
        "customer": {
            "id": "customer123"
        },
        "provider_extra_fields": {
            "bank_trx_id": "IGef88425f-1234"
        },
        "operation": {
            "id": 9912000002236,
            "type": "payout",
            "status": "success",
            "created_date": "2025-09-12T13:22:15+0000",
            "date": "2025-09-12T13:28:58+0000",
            "request_id": "b54610e94a76",
            "sum_initial": {
                "amount": 12300,
                "currency": "SGD"
            },
            "sum_converted": {
                "amount": 12300,
                "currency": "SGD"
            },
            "code": "0",
            "message": "Success",
            "provider": {
                "id": 21635,
                "payment_id": "IGef88425f-1234",
                "date": "2025-09-12T13:28:34+0000",
                "auth_code": ""
            },
        },
        "signature": "10zy9TNiJLT0P/+EOrpMkoW80mynkaQfSAUJpfQ=="
    }                 
}

В следующем примере оповещение свидетельствует о том, что выплата была отклонена.

{
        "project_id": 433772,
        "payment": {
            "id": "PAYOUT78966",
            "type": "payout",
            "status": "decline",
            "date": "2025-09-07T09:44:43+0000",
            "method": "Singapore Banks",
            "sum": {
                "amount": 12300,
                "currency": "SGD"
            },
            "description": ""
        },
        "account": {
            "number": "***6789"
        },
        "customer": {
            "id": "customer123"
        },
        "operation": {
            "id": 533000002202,
            "type": "payout",
            "status": "decline",
            "date": "2025-09-07T09:44:43+0000",
            "created_date": "2022-09-07T09:44:43+0000",
            "request_id": "205d3536a91f4737d679ae44f5c707e248258224fe3f6",
            "sum_initial": {
                "amount": 12300,
                "currency": "SGD"
            },
            "sum_converted": {
                "amount": 12300,
                "currency": "SGD"
            },
            "code": "20000",
            "message": "General decline",
            "provider": {
                "id": 21635,
                "payment_id": "",
                "auth_code": ""
            },
        },
        "signature": "j4cxKDvx0EtSJw0bHot6v83rzDMlinxE915lAWGHKVjurpQ=="
    }
}

Дополнительные материалы

Для организации работы с выплатами через Gate также могут быть полезны следующие материалы:

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