Ecommpay

This page provides an overview of the payments methods provided by the Ecommpay adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating Ecommpay within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Because of a restriction on Ecommpay side, you need to set the particular setting "Accept postbacks from other connectors (list GUIDs comma-separated)" inside the connector where you passed the notification URL to Ecommpay if you want to configure multiple connectors.

As a value you need to pass the connector ID from all other Ecommpay connectors of the same account, example: CO-8ce8-4ed7-e9d9-9261-715a-fad8,CO-02c7-62dd-d0e8-5918-6373-7e75. With this setting, all connectors will work with the same notification URL. This setting only needs to be set on the connector where you passed the notification URL to Ecommpay.

If you only have one connector per Ecommpay account, you don't need to configure this setting.

Payment Methods

Payment Method	Transaction Flows	Transaction Types	Supported Currencies
Alipay	Redirect	Debit, Refund* **	AUD, CAD, CNY, EUR, GBP, HKD, JPY, SGD, USD
China Union Pay (CUP P2P)	Redirect	Debit, Payout*	CNY
DOKU Wallet	Redirect	Debit, Payout*	IDR
Nganluong Wallet	Redirect	Debit, Payout*	VND
Bank Transfer Indonesia	Redirect	Debit, Payout*	IDR
Bank Transfer Malaysia	Redirect	Debit, Payout*	MYR
Bank Transfer Philippines	Redirect	Debit, Payout*	PHP
Bank Transfer Korea	Redirect	Debit, Payout*	KRW
Bank Transfer Thailand	Redirect	Debit, Payout*	THB
Bank Transfer Thailand QR	Redirect	Debit	THB
Bank Transfer Vietnam	Redirect	Debit, Payout*	VND
Bank Transfer Vietnam QR	Redirect	Debit	VND

*Payout/Refund doesn't require any customer interaction or redirection.

**For Alipay refunds you have to activate the merchant_refund_id field on Ecommpay side. Please talk to your Ecommpay Account Manager for further information.

Additional parameters for BankTransfer Debit

Extra Data	Required	Description
Customer - Identification	true	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - First name	true	For Korea: the name entered needs to be the same as the account holder
Customer - Last name	true	For Korea: the surname entered needs to be the same as the account holder
Customer - EMail	true
Customer - Phone	false
Customer - Country	false
Customer - City	false
Customer - State	false
Customer - Postcode	false
Customer - National Id	false

Additional parameters for BankTransfer Payout

Extra Data	Required	Description
Customer - Identification	true	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - First name	true
Customer - Last name	true
Customer - EMail	true
Customer - IP Address	true
extraData.account_number	true	Customer account number
extraData.bank_id	true	Bank identifier*
extraData.bank_branch	true	Bank branch identifier
extraData.bank_city	true	Bank branch city
extraData.region_id	true	Region identifier**

*To retrieve a list of bank identifiers you need to send an options request with the identifier debit-bank-list or payout-bank-list and as parameter the bank name (available: vietnam, malaysia, philippines, indonesia, thailand).

** To retrieve a list of region identifiers you need to send an options request with the identifier region-list and as parameter the bank name(available: vietnam, malaysia, philippines, indonesia, thailand).

You can find more information about the options request here: Options Request

Additional parameters for AliPay / DOKU Wallet / Nganluong Wallet Debit

Extra Data	Required	Description
Customer - Identification	false	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - First name	false
Customer - Last name	false
Customer - EMail	false
Customer - Phone	false
Customer - Country	false
Customer - City	false
Customer - State	false
Customer - National Id	false

Additional parameters for China Union Pay Payout

Extra Data	Required	Description
Customer - Identification	true	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - First name	true
Customer - Last name	true
Customer - IP Address	true
Customer - EMail	true
Customer - Phone	true
Customer - Address	true
Customer - Country	true	Need to be CN
Customer - City	true
Customer - State	true
Customer - Postcode	true
extraData.bank_id	true	Bank identifier*
extraData.bank_branch	true	Bank branch identifier
extraData.bank_city	true	Bank branch city
extraData.region_id	true	Region identifier**
extraData.doc_number	false	Document number

*To retrieve a list of bank identifiers you need to send an options request with the identifier debit-bank-list or payout-bank-list and as parameter the bank name (available: vietnam, malaysia, philippines, indonesia, thailand).

**To retrieve a list of region identifiers you need to send an options request with the identifier region-list and as parameter the bank name (available: vietnam, malaysia, philippines, indonesia, thailand).

You can find more information about the options request here: Options Request

Additional parameters for Alipay Refund

Extra Data	Required	Description
Description	true
Customer - Ip Address	true

Additional parameters for Nganluong Wallet Payout

Extra Data	Required	Description
Customer - Identification	true	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - IP Address	true
extraData.account_number	true

Additional parameters for DOKU Wallet Payout

Extra Data	Required	Description
Customer - Identification	true	Unique customer identification, should be used on multiple payments if it is the same customer
Customer - First name	true
Customer - Last name	true
Customer - EMail	true
Customer - IP Address	true
Customer - Phone	true
Customer - City	true
Customer - Country	true
Customer - Birthday	true
extraData.wallet_number	true	Customer account number
extraData.doc_number	true	Document number
extraData.doc_type	true	Document type
extraData.doc_issue_country	true	An ISO 3166-1 (alpha-2) code of country that issued the document