Deprecated API Reference

This API Reference is being deprecated. Please use the New API Reference.

Create a Sale with Level 2 Processing

Combines both the create authorization and capture authorization API calls into one.

See the request arguments table below for the fields that are required to meet Level 2 processing for an transfer.

A merchant first needs to be enabled for Level 2 and Level 3: Update Merchant to Enable Level 2/Level 3 Processing.

Copy
Copied
curl https://finix.sandbox-payments-api.com/transfers \
    -H "Content-Type: application/vnd.json+api" \
    -H 'Finix-Version:2022-02-01' \
    -u  USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e \
    -d '
	{
	    "merchant": "MUeDVrf2ahuKc9Eg5TeZugvs",
	    "source": "PIe2YvpcjvoVJ6PzoRPBK137",
	    "additional_purchase_data": {
	        "customer_reference_number": "321xyz",
	        "sales_tax": 200
	    },
	    "tags": {
	        "test": "sale"
	    },
	    "currency": "USD",
	    "amount": 1000
	}'

Example Response:

Copy
Copied
{
  "id" : "TRvG5YvLrSRr1dcVnmyg7aJs",
  "amount" : 1000,
  "tags" : {
    "test" : "sale"
  },
  "state" : "PENDING",
  "trace_id" : "a824fdf6-88cb-417f-9f74-2a522dfd9774",
  "currency" : "USD",
  "application" : "APgPDQrLD52TYvqazjHJJchM",
  "source" : "PIe2YvpcjvoVJ6PzoRPBK137",
  "destination" : null,
  "ready_to_settle_at" : null,
  "externally_funded" : "UNKNOWN",
  "fee" : 0,
  "statement_descriptor" : "FNX*FINIX FLOWERS",
  "type" : "DEBIT",
  "messages" : [ ],
  "raw" : null,
  "created_at" : "2022-01-27T07:37:11.51Z",
  "updated_at" : "2022-01-27T07:37:11.84Z",
  "idempotency_id" : null,
  "merchant_identity" : "IDuqZpDw28f2KK6YuDk4jNLg",
  "subtype" : "API",
  "_links" : {
    "application" : {
      "href" : "https://finix.sandbox-payments-api.com/applications/APgPDQrLD52TYvqazjHJJchM"
    },
    "self" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRvG5YvLrSRr1dcVnmyg7aJs"
    },
    "merchant_identity" : {
      "href" : "https://finix.sandbox-payments-api.com/identities/IDuqZpDw28f2KK6YuDk4jNLg"
    },
    "payment_instruments" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRvG5YvLrSRr1dcVnmyg7aJs/payment_instruments"
    },
    "reversals" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRvG5YvLrSRr1dcVnmyg7aJs/reversals"
    },
    "fees" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRvG5YvLrSRr1dcVnmyg7aJs/fees"
    },
    "disputes" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRvG5YvLrSRr1dcVnmyg7aJs/disputes"
    },
    "source" : {
      "href" : "https://finix.sandbox-payments-api.com/payment_instruments/PIe2YvpcjvoVJ6PzoRPBK137"
    },
    "fee_profile" : {
      "href" : "https://finix.sandbox-payments-api.com/fee_profiles/FPbDSnEPtaT8Nttxj9NJk7eC"
    }
  }
}

HTTP Request

POST https://finix.sandbox-payments-api.com/transfers

Request Arguments

Field Type Description
source string, required ID of the Payment Instrument that will be debited
merchant string, required merchant ID of the merchant whom you're charging on behalf of
amount integer, required The total amount that will be debited in cents (e.g. 100 cents to debit $1.00)
fee integer, optional The amount of the transfer you would like to collect as your fee in cents. Defaults to zero (Must be less than or equal to the amount)
currency string, required 3-letter ISO code designating the currency of the transfers (e.g. USD)processor
idempotency_id string, optional A randomly generated value that you want associated with the request
tags object, optional Key value pair for annotating custom metadata (e.g. order numbers)

additional_purchase_data-object Request Arguments

Field Type Description
customer_reference_number string, required The customer reference for the purchase (max 17 characters)
customs_duty_amount integer, optional The duty in cents on the total purchase amount for the order
destination_country_code string, optional The ISO country code of the order destination
destination_postal_code string, optional The postal code of the order destination (10 characters)
discount_amount integer, optional The amount in cents of the discount for the order
invoice_reference_number string, optional The order's invoice number (max 15 characters)
sales_tax integer, required Total aggregate tax amount in cents for the entire purchase. Field is automatically calculated if you pass in the itemized tax amounts. For non-taxable transactions either set sales_tax to 0 or omit from payload and also set tax_exempt to true.
ship_from_postal_code string, optional The postal code from where order is shipped (10 characters)
shipping_amount integer, optional The shipping cost in cents for the order
tax_exempt boolean, optional For tax exempt purchases set to True

order_date-object Request Arguments

Field Type Description
day integer, optional Day of purchase (between 1 and 31)
month integer, optional Month of purchase (between 1 and 12)
year integer, optional Year of purchase (4-digit)

item_data-object Request Arguments

Field Type Description
amount_excluding_sales_tax integer, optional Total cost in cents of the line item excluding tax
amount_including_sales_tax integer, optional Total cost in cents of the line item including tax
commodity_code string, optional A commodity code is a numeric code representing a particular product or service as defined by the National Institute of Governmental Purchasing. The code can be 3, 5, 7, or 11 digits in length. The longer the code the more granular the description of the product/service. (max 12 characters)
cost_per_unit integer, optional The price in cents of one unit of the item purchased
item_description string, optional Required when item_data is supplied (max 25 characters)
item_discount_amount integer, optional Item discount amount in cents
merchant_product_code string, optional Merchant defined product code (max 12 characters)
quantity integer, optional The number of items purchased. Must be greater than 0.
unit_of_measure string, optional The unit of measure of the purchased item (max 3 characters)