Payments for orders can either be settled by Shopgate or by the merchant. The deciding factor here is the implementation method: for payments executed by Shopgate the merchant only needs to send the goods when they are released for shipping. If payments are executed by the merchant, however, they should also ensure that an appropriate amount is collected, for example via direct debit. Such merchant-side payment settlement methods are partially supported by shop systems. A provisional solution needs to be put in place for unsupported payment methods to enable the merchants to correctly process their orders.
Payments settled by Shopgate
All orders placed with the Shopgate Credit Card, Shopgate Prepayment, Shopgate Direct Debit or Shopgate Invoice payment method are settled by Shopgate. Orders placed in apps or via the mobile website can be settled through Shopgate as well. E.g. when the merchant doesn’t have payment via credit card implemented in his shopping cart solution but still wants to offer it in his apps he can let Shopgate execute the payment process.
When importing such an order, the payment_group and payment_method fields are always set to “SHOPGATE”. Only the shopgate_payment_name index is set in the array payment_infos. The merchant should be shown the string provided there as the payment method. A module called “Shopgate” needs to be implemented in the online shop to ensure that orders settled via Shopgate are presented correctly.
If an order placed through the merchant’s app uses a payment method settled by the merchant, the exact procedure depends on whether the online shop already supports this payment method or not.
Supported Payment Methods
If the payment method is supported by the online shop, the payment information part of the order should be imported in exactly the same way as if the order was placed directly through the online shop. If there is any necessary information to do that, it is located in the payment_infos field of the imported order. E.g. if the customer places the order with “Direct Debit” as the payment option, the account information needed to execute the direct debit payment can be found in payment_infos under bank_account_holder, bank_account_number, bank_code, bank_name, iban and bic. The information that is stored for each payment method is described in the specifications.
Unsupported Payment Methods
The merchant should be shown “Mobile Payment” as payment method for methods unsupported by the online shop. The information from the payment_infos field required by the merchant for the execution of the order must be placed clearly visible, e.g. as a comment to the order. The aforementioned Shopgate payment module can also be used to easily ensure that orders which use a payment method unsupported by the online shop and are settled by the merchant are presented correctly.
List of Payment Methods
These objects replace the “payment_infos” object. Depending on the payment method selected for an order, an appropriate table below replaces the object listed on the Merchant API - get_orders Response page…
- Amazon Payments
- Cash on Delivery
- Credit Card
- Credit card (redirect)
- Direct Debit
- Direct Debit (external)
- Giropay
- Installment
- Invoice
- MasterCard
- Merchant payment
- On-site pickup
- Pay in store
- PayPal
- PayU
- Prepayment
- SOFORT Überweisung
- Shopgate
- iDEAL