Payment Methods

Overview

Payment methods refer to incoming payments only. For outgoing payments, please refer to Disbursement Methods. Assembly supports multiple payment types for making payments on your platform. You can offer your buyers the ability to pay via Credit & Debit Cards, Bank Account (ACH/Direct Debit), Digital Wallets, International Wire Transfer and BPAY. When choosing a payment method to offer your users, you should consider payment processing times, currency support, and associated fees. Payment Methods

Credit/Debit Cards

Credit/Debit Cards can be used as a payment method.

Supported Cards

Assembly supports VISA, MasterCard and AMEX (for US platforms only) Credit and Debit cards.

Processing

Credit/Debit Cards are charged immediately. Assembly provides notification via the ‘make_payment’ API response if there are issues processing the card, such as; insufficient funds, an expired card or incorrect details. In the event of possible fraudulent activity, a card will be charged immediately and Assembly may place the payment into a ‘payment_held’ state. The transaction may require further risk and fraud analysis before being accepted or denied. In either case, a callback can be initiated from Assembly, to your platform to inform you of the outcome. The analysis can take between 5 minutes and 30 minutes. Additional information may be requested from the buyer.

Currencies

Credit/Debit Cards can be charged in all supported currencies. Currencies are set when creating an Item and the card will be charged in the currency selected. The issuing bank may charge a currency conversion cost to the buyer if the card’s currency is not the same as requested.

Surcharges/Fees

Assembly charges a surcharge for using a Credit/Debit Card as a payment method. As a platform, you may want to charge your users a surcharge for using a Credit/Debit Card as the payment method. These fees can be configured using the Fees API and associated with the Item. The surcharge will be added to the amount of the Item and will be charged to the buyer in a single total transaction amount. In the event of a refund, the Fees will be proportionally refunded.

Refunds

Refunds to Credit/Debit Cards are refunded immediately. In the event that the card has been cancelled, Assembly may need to contact the buyer to obtain an alternative disbursement method.

Managing Cards

Creating Credit/Debit Cards is performed using either our PromisePay.js tool, the EUI or via the Assembly Card Accounts API. All platforms and marketplaces that provide Credit/Debit Cards as a payment method must be PCI DSS compliant. There are PCI DSS implications for each method of managing cards, that need to be considered. For more information, please visit the PCI DSS section.

Bank Accounts

Bank Accounts can be used as a payment method through direct debit or ACH.

Supported Countries

Australian, New Zealand and United States bank accounts can be used as a payment method.

Processing

Bank Account payments are batched. We provide notification via the ‘make_payment’ API response that the payment is being processed. The batch process runs several times per day and it can take up to 3 business days for funds to be retrieved from the Bank Account. Assembly provides notification of the success or failure of the payment via the Batch Callback. In the event of possible fraudulent activity, Assembly may place the payment into a ‘payment_held’ state. The transaction may require further risk and fraud analysis before being accepted or denied. In either case, a callback can be initiated from Assembly to your platform to inform you of the outcome. The analysis can take between 5 minutes and 30 minutes. Additional information may be requested from the buyer in the event of suspected fraudulent activity.

Currencies

Bank Accounts can be charged in AUD, NZD or USD depending upon the country that the account is held in. The currency of the Bank Account is set and fixed when creating the account. It can only be used to fund Items with the same currency set.

Surcharges/Fees

Assembly charges a surcharge for using a Bank Account as a payment method. As a platform, you may want to charge your users a surcharge for using a Bank Account as the payment method. These fees can be configured using the Fees API and associated with the Item. The surcharge will be added to the amount of the Item and will be charged to the buyer in a single total transaction amount. In the event of a refund, the fees will be proportionally refunded.

Refunds

Refunds to Bank Accounts are batched. The batch process runs several times per day and can take up to 2 business days for funds to be returned. Assembly provides success or failure notification via the Batch Callback API. In the event that the Bank Account has been closed, Assembly may need to contact the buyer to obtain an alternative disbursement method.

Managing Bank Accounts

Creating Bank Accounts is performed using either the EUI or via the Bank Accounts API. Bank Account details cannot be updated and as such, a new Bank Account must be created and linked to the user in the event of incorrect details.

Direct Debit Authorities

A Direct Debit Authority is required in order to use a Bank Account as a payment method. It is required for all Bank Accounts regardless of country. The Direct Debit Authority can be obtained either using the EUI or the Direct Debit Authority API.

Digital Wallets

Digital Wallets can be used as a payment method if the platform is configured with manual Digital Wallet disbursements. Every User is given a Digital Wallet by default.

Processing

Digital Wallet payments are processed immediately. They are applied from existing funds already held on behalf of the user. By default, the User’s Digital Wallet balance will be automatically disbursed to them as per the batch schedule (several times per day). A platform can request that Digital Wallets be set to manual disbursements, and as such funds can be held indefinitely on behalf of the user and be used to fund future Items.

Currencies

The User’s Digital Wallet currency is fixed to the default currency of the platform (AUD, NZD or USD).

Surcharges / Fees

Assembly charges a surcharge for using a Digital Wallet as a payment method. As a platform, you may want to charge your users a surcharge for using a Digital Wallet as the payment method. These fees can be configured using the Fees API and associated with the Item. The surcharge will be added to the amount of the Item and will be charged to the buyer in a single total transaction amount. In the event of a refund, the fees will be proportionally refunded.

Refunds

Refunds to Digital Wallets are immediate and are returned to the Digital Wallet that was used as the payment source.

Managing Digital Wallets

Every user is given a Digital Wallet upon creation of the User object. A Digital Wallet can be funded using a Bank Account or from the proceeds of Item disbursements. Funds are automatically disbursed from a User’s Digital Wallet by default. Contact Assembly support if you want to manually disburse funds and by implication, allow the Digital Wallet to be used as a funding source.

Domestic & International Wire Transfers

Funds can be wired to Assembly and be used as payment for Items.

Supported Countries

All countries are supported.

Processing

International Wire Transfers are generally received within 5 days. However, for some countries, it can take up to 14 days for Assembly to receive the funds. As soon as funds are received, they will be applied to the transaction.

Currencies

Assembly can receive international wires in various currencies. The currency required to be sent will depend on the currency of the Item.

Surcharges / Fees

Assembly does not charge a fee to receive funds via a Wire Transfer. In the event of an international wire refund, Assembly will charge a fee to send the funds. As a platform, you may want to charge your users a surcharge for sending the international wire transfer refund. These fees can be configured using the Fees API. The fee will be subtracted from the refund amount.

Refunds

Refunding funds provided via a Wire Transfer requires a Bank Account to be created for the User. The Bank Account is only required for the refund and not the actual wire transfer.

Managing International Wire Transfers

Each Item that is created is given a deposit reference. The deposit reference should be used to identify what the funds are being sent for. The deposit reference is available via the Item Wire Details API Call.

BPAY

Funds can be sent to Assembly using BPAY and can then be used as payment for items.

Supported Countries

Only Australia supports BPAY.

Processing

BPAY payments are generally received overnight. As soon as funds are received, they will be applied to the Item.

Currencies

BPAY supports AUD only.

Surcharges / Fees

Assembly charges a surcharge for using BPAY as a payment method.

Refunds

Refunding funds provided via a BPAY requires a Bank Account to be created for the User. The Bank Account is only required for the refund, not the actual BPAY transfer.

Managing BPAY Payments

Each Item that is created is given a deposit reference. The deposit reference should be used as the BPAY Biller Reference. It will identify the what Item the funds are paying for. The deposit reference is available via the Item BPAY Details API Call.