How Merchants Work

With a basic understanding About Merchants let's see exactly how they work. No matter what merchant you integrate with, the way the integration is done, is the same, The only difference between each type of merchant is the way Directscale processed that merchant.

Merchant Types

Each merchant type has their own set of endpoints.

  • The CommissionMerchant is used for Money Out. It is used to Pay Commissions back to associates.

    • Provision Commissions Acct Endpoint - Used for provisioning an account for an associate. This is called one time for each associate when they earn a commission.
    • Pay Commissions Endpoint - Endpoint for processing payments. This is called when a batch is processed for this merchant in the Directscale system.
  • The SavedPaymentMoneyInMerchant is used for Money In. It is used by the ordering system for receiving money for an order. It will save the payment on file and can be used for future purchases and autoships.

    • Charge Payment Endpoint - Endpoint to process a payment
    • Refund Payment Endpoint - Endpoint to process a refund.
    • Get New Payer Id Endpoint - Used for provisioning a new account for an associate. This is called one time for each associate the first time they use the merchant.
    • Get Save Payment Frame Endpoint - The URL for the Iframe to take the payment.
    • Delete Payment Endpoint - Endpoint to delete a saved payment.
    • Get External Payments Endpoint - This is used to get a list of external payments. This is helpfull if the merchant you are integrating to has a way to add payments outside the Directscale system.
    • Validate Currency Endpoint - This will validate if the currency of the order is appropriate for this merchant.
    • Validate Payment Endpoint - This will validate if the payment object for the order is valid.
  • The SinglePaymentMoneyInMerchant is used for Money In.

    • Charge Payment Endpoint - Endpoint to process a payment
    • Refund Payment Endpoint - Endpoint to process a refund.
    • Get New Payer Id Endpoint - Used for provisioning a new account for an associate. This is called one time for each associate the first time they use the merchant.
    • Validate Currency Endpoint - This will validate if the currency of the order is appropriate for this merchant.
    • Validate Payment Endpoint - This will validate if the payment object for the order is valid.
  • The RedirectMoneyInMerchant is used for Money In.

    • Charge Payment Endpoint - The Url to redirect the use to when an order is processed.
    • Refund Payment Endpoint - Endpoint to process a refund.
    • Get New Payer Id Endpoint - Used for provisioning a new account for an associate. This is called one time for each associate the first time they use the merchant.
    • Validate Currency Endpoint - This will validate if the currency of the order is appropriate for this merchant.
    • Validate Payment Endpoint - This will validate if the payment object for the order is valid.

Did this page help you?