Create a Transfer

Create a Transfer.

Request
Request Body schema: application/hal+json
object or null

Object detailing any Buyer Charges that got included in the Authorization.

object

Optional object detailing specific healthcare amounts.

object

Additional information about the purchase. Used for Level 2 and Level 3 Processing.

adjustment_request
boolean or null

Details if the transfer was created to adjust funds.

amount
required
integer <int64>

The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

currency
required
string

ISO 4217 3 letter currency code.

Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XXX" "YER" "ZAR" "ZMW" "ZWL"
destination
string or null

ID of the Payment Instrument where funds will be sent.

device
string or null

The ID of the activated device.

object

Configure the details of the activated device.

fee
integer <int64>

The amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the amount).

fraud_session_id
string

The fraud_session_session ID you want to review for fraud. For more info, see Fraud Detection.

hsa_fsa_payment
boolean or null

Set to to true to process a payment using a Payment Instrument created from a health savings account (HSA) or flexible spending account (FSA).

idempotency_id
string or null

A randomly generated value that'll be associated with the request.

merchant
string or null

ID of the Merchant the Transfer was created under.

operation_key
string or null

Details the operation that'll be performed in the transaction.

Enum: "PUSH_TO_CARD" "PULL_FROM_CARD" "CARD_PRESENT_DEBIT" "CARD_PRESENT_UNREFERENCED_REFUND" "SALE" "UNREFERENCED_REFUND" "MERCHANT_CREDIT_ADJUSTMENT" "MERCHANT_DEBIT_ADJUSTMENT"
object

Details the Payment Instrument that the Transfer debits or credits.

processor
string

Name of the transaction processor.

source
string

ID of the Payment Instrument where funds get debited.

statement_descriptor
string or null
  • The description of the transaction that appears on the buyer's bank or card statement.
  • statement_descriptors for `Transfers` in live enviroments will have a FI* prefix.
  • object

    Key value pair for annotating custom meta data (e.g. order numbers).

    object or null

    The 3D secure information for an authorization.

    Responses
    201

    Single Transfer object

    Response Schema: application/hal+json
    id
    string

    The ID of the Transfer resource.

    created_at
    string <date-time>

    Timestamp of when the object was created.

    updated_at
    string <date-time>

    Timestamp of when the object was last updated.

    object or null

    Object detailing any Buyer Charges that got included in the Authorization.

    object

    Optional object detailing specific healthcare amounts.

    amount
    integer <int64>

    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

    application
    string

    The ID of the Application the Transfer was created under.

    object or null

    Details needed to process card present transactions.

    currency
    string

    ISO 4217 3 letter currency code.

    Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XXX" "YER" "ZAR" "ZMW" "ZWL"
    destination
    string or null

    The ID of the destination.

    device
    string

    The ID of the Device resource the Transfer was created under.

    externally_funded
    string

    Details if the Transfer will be settled externally by card processors.

    failure_code
    string or null

    The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see Failure Codes.

    failure_message
    string or null

    A human-readable description of why the transaction was declined. This will also include a suggestion on how to complete the payment.

    fee
    integer <int64>

    The amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the amount).

    fee_type
    string

    The type of fee.

    Enum: "APPLICATION_FEE" "ACH_BASIS_POINTS" "ACH_FIXED" "CARD_BASIS_POINTS" "CARD_FIXED" "CARD_INTERCHANGE" "VISA_BASIS_POINTS" "VISA_FIXED" "VISA_INTERCHANGE" "VISA_ASSESSMENT_BASIS_POINTS" "VISA_ACQUIRER_PROCESSING_FIXED" "VISA_CREDIT_VOUCHER_FIXED" "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED" "VISA_BASE_II_CREDIT_VOUCHER_FIXED" "VISA_KILOBYTE_ACCESS_FIXED" "DISCOVER_BASIS_POINTS" "DISCOVER_FIXED" "DISCOVER_INTERCHANGE" "DISCOVER_ASSESSMENT_BASIS_POINTS" "DISCOVER_DATA_USAGE_FIXED" "DISCOVER_NETWORK_AUTHORIZATION_FIXED" "DINERS_CLUB_BASIS_POINTS" "DINERS_CLUB_FIXED" "DINERS_CLUB_INTERCHANGE" "MASTERCARD_BASIS_POINTS" "MASTERCARD_FIXED" "MASTERCARD_INTERCHANGE" "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS" "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS" "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS" "JCB_BASIS_POINTS" "JCB_FIXED" "JCB_INTERCHANGE" "AMERICAN_EXPRESS_BASIS_POINTS" "AMERICAN_EXPRESS_FIXED" "AMERICAN_EXPRESS_INTERCHANGE" "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS" "DISPUTE_INQUIRY_FIXED_FEE" "DISPUTE_FIXED_FEE" "QUALIFIED_TIER_BASIS_POINTS_FEE" "QUALIFIED_TIER_FIXED_FEE" "CUSTOM" "ACH_DEBIT_RETURN_FIXED_FEE" "ACH_CREDIT_RETURN_FIXED_FEE" "ANCILLARY_FIXED_FEE_PRIMARY" "ANCILLARY_FIXED_FEE_SECONDARY" "SETTLEMENT_V2_TRANSFER"
    hsa_fsa_payment
    boolean or null

    Set to to true to process a payment using a Payment Instrument created from a health savings account (HSA) or flexible spending account (FSA).

    idempotency_id
    string or null

    ID to idempotently identifty the transfer.

    merchant_identity
    string

    The ID of the Merchant the Authorization was created under.

    messages
    Array of strings

    Message field that provides additional details. This field is typically null.

    (Raw (object or null)) or (Raw (string or null))

    Raw response from the processor.

    ready_to_settle_at
    string or null <date-time>

    Timestamp of when the Transfer is ready to be settled at.

    source
    string

    The ID of the Payment Instrument that will be debited and performing the Transfer.

    state
    string

    The stauts of the Transfer.

    Enum: "CANCELED" "PENDING" "FAILED" "SUCCEEDED" "UNKNOWN"
    statement_descriptor
    string or null
  • The description of the seller that appears on the buyer's bank or card statement.
  • statement_descriptors for `Transfers` in live enviroments will have a FI* prefix.
  • subtype
    string

    Additional information describing the payment_type.

    Enum: "API" "APPLICATION_FEE" "DISPUTE" "MERCHANT_CREDIT" "MERCHANT_CREDIT_ADJUSTMENT" "MERCHANT_DEBIT" "MERCHANT_DEBIT_ADJUSTMENT" "PLATFORM_CREDIT" "PLATFORM_CREDIT_ADJUSTMENT" "PLATFORM_DEBIT" "PLATFORM_DEBIT_ADJUSTMENT" "PLATFORM_FEE" "SETTLEMENT_MERCHANT" "SETTLEMENT_NOOP" "SETTLEMENT_PARTNER" "SETTLEMENT_PLATFORM" "SPLIT_PAYOUT" "SPLIT_PAYOUT_ADJUSTMENT" "SYSTEM"
    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    trace_id
    string or null

    Trace ID of the Transfer. The processor sends back the trace_id so you can track the Transfer end-to-end.

    type
    string

    Type of Transfer.

    Enum: "DEBIT" "CREDIT" "REVERSAL" "FEE" "ADJUSTMENT" "DISPUTE" "RESERVE" "SETTLEMENT" "UNKNOWN"
    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    400

    Error

    401

    Authentication information is missing or invalid

    402

    402 - Payment required

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    422

    Invalid field

    post/transfers
    Request samples
    Response samples
    application/hal+json
    {}

    List Transfers

    Retrieve a list of Transfers.

    Request
    query Parameters
    sort
    string

    Specify key to be used for sorting the collection.

    after_cursor
    string

    Return every resource created after the cursor value.

    limit
    integer

    The numbers of items to return.

    Example: limit=10
    amount
    integer

    Filter by an amount equal to the given value.

    amount.gte
    integer

    Filter by an amount greater than or equal.

    amount.gt
    integer

    Filter by an amount greater than.

    amount.lte
    integer

    Filter by an amount less than or equal.

    amount.lt
    integer

    Filter by an amount less than.

    created_at.gte
    string

    Filter where created_at is after the given date.

    Example: created_at.gte=created_at.gte=2019-06-15
    created_at.lte
    string

    Filter where created_at is before the given date.

    Example: created_at.lte=created_at.lte=2019-06-15
    idempotency_id
    string

    Filter by idempotency_id.

    id
    string

    Filter by id.

    state
    any

    Filter by Transaction state.

    Enum: "ALL" "SUCCEEDED" "FAILED" "PENDING" "CANCELED"
    ready_to_settle_at.gte
    string

    Filter by ready_to_settle_at.

    ready_to_settle_at.lte
    string

    Filter by ready_to_settle_at.

    statement_descriptor
    integer

    Filter by statement_descriptor.

    trace_id
    string

    Filter by trace_id.

    updated_at.gte
    string

    Filter where updated_at is after the given date.

    updated_at.lte
    string

    Filter where updated_at is before the given date.

    instrument_bin
    string

    Filter by Bank Identification Number (BIN). The BIN is the first 6 digits of the masked number.

    instrument_account_last4
    string

    Filter Transactions by the last 4 digits of the bank account. The bank account last 4 are the last 4 digits of the masked number instrument_account_last4=9444 BIN.

    instrument_brand_type
    string

    Filter by card brand. Available card brand types can be found in the drop-down.

    merchant_identity_id
    string

    Filter by Identity ID.

    merchant_identity_name
    string

    Filter Transactions by Identity name. The name is not case-sensitive.

    instrument_name
    string

    Filter Transactions by Payment Instrument name.

    instrument_type
    string

    Filter Transactions by Payment Instrument type. Available instrument types include: Bank Account or Payment Card

    merchant_id
    string

    Filter by Merchant ID.

    merchant_mid
    string

    Filter by Merchant Identification Number (MID).

    instrument_card_last4
    string

    Filter by the payment card last 4 digits.

    merchant_processor_id
    string

    Filter by Processor ID.

    type
    string

    Filter by Transfer type. Available type filters include: All, Debits, Refunds, or Credits.

    Enum: "ALL" "DEBITS" "CREDITS" "REVERSAL" "SETTLEMENT"
    Example: type=REVERSAL
    before_cursor
    string

    Return every resource created before the cursor value.

    Responses
    200

    List of Transfer objects

    Response Schema: application/hal+json
    object

    Details the page that's returned.

    object

    List of Transfer objects.

    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    401

    Authentication information is missing or invalid

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    get/transfers
    Request samples
    curl https://finix.sandbox-payments-api.com/transfers \
      -H "Content-Type: application/vnd.json+api" \
      -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
    
    Response samples
    application/hal+json
    {}

    Fetch a Transfer

    Retrieve a Transfer.

    Request
    path Parameters
    transfer_id
    required
    string

    ID of Transfer resource.

    Responses
    200

    Single Transfer object

    Response Schema: application/hal+json
    id
    string

    The ID of the Transfer resource.

    created_at
    string <date-time>

    Timestamp of when the object was created.

    updated_at
    string <date-time>

    Timestamp of when the object was last updated.

    object or null

    Object detailing any Buyer Charges that got included in the Authorization.

    object

    Optional object detailing specific healthcare amounts.

    amount
    integer <int64>

    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

    application
    string

    The ID of the Application the Transfer was created under.

    object or null

    Details needed to process card present transactions.

    currency
    string

    ISO 4217 3 letter currency code.

    Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XXX" "YER" "ZAR" "ZMW" "ZWL"
    destination
    string or null

    The ID of the destination.

    device
    string

    The ID of the Device resource the Transfer was created under.

    externally_funded
    string

    Details if the Transfer will be settled externally by card processors.

    failure_code
    string or null

    The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see Failure Codes.

    failure_message
    string or null

    A human-readable description of why the transaction was declined. This will also include a suggestion on how to complete the payment.

    fee
    integer <int64>

    The amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the amount).

    fee_type
    string

    The type of fee.

    Enum: "APPLICATION_FEE" "ACH_BASIS_POINTS" "ACH_FIXED" "CARD_BASIS_POINTS" "CARD_FIXED" "CARD_INTERCHANGE" "VISA_BASIS_POINTS" "VISA_FIXED" "VISA_INTERCHANGE" "VISA_ASSESSMENT_BASIS_POINTS" "VISA_ACQUIRER_PROCESSING_FIXED" "VISA_CREDIT_VOUCHER_FIXED" "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED" "VISA_BASE_II_CREDIT_VOUCHER_FIXED" "VISA_KILOBYTE_ACCESS_FIXED" "DISCOVER_BASIS_POINTS" "DISCOVER_FIXED" "DISCOVER_INTERCHANGE" "DISCOVER_ASSESSMENT_BASIS_POINTS" "DISCOVER_DATA_USAGE_FIXED" "DISCOVER_NETWORK_AUTHORIZATION_FIXED" "DINERS_CLUB_BASIS_POINTS" "DINERS_CLUB_FIXED" "DINERS_CLUB_INTERCHANGE" "MASTERCARD_BASIS_POINTS" "MASTERCARD_FIXED" "MASTERCARD_INTERCHANGE" "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS" "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS" "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS" "JCB_BASIS_POINTS" "JCB_FIXED" "JCB_INTERCHANGE" "AMERICAN_EXPRESS_BASIS_POINTS" "AMERICAN_EXPRESS_FIXED" "AMERICAN_EXPRESS_INTERCHANGE" "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS" "DISPUTE_INQUIRY_FIXED_FEE" "DISPUTE_FIXED_FEE" "QUALIFIED_TIER_BASIS_POINTS_FEE" "QUALIFIED_TIER_FIXED_FEE" "CUSTOM" "ACH_DEBIT_RETURN_FIXED_FEE" "ACH_CREDIT_RETURN_FIXED_FEE" "ANCILLARY_FIXED_FEE_PRIMARY" "ANCILLARY_FIXED_FEE_SECONDARY" "SETTLEMENT_V2_TRANSFER"
    hsa_fsa_payment
    boolean or null

    Set to to true to process a payment using a Payment Instrument created from a health savings account (HSA) or flexible spending account (FSA).

    idempotency_id
    string or null

    ID to idempotently identifty the transfer.

    merchant_identity
    string

    The ID of the Merchant the Authorization was created under.

    messages
    Array of strings

    Message field that provides additional details. This field is typically null.

    (Raw (object or null)) or (Raw (string or null))

    Raw response from the processor.

    ready_to_settle_at
    string or null <date-time>

    Timestamp of when the Transfer is ready to be settled at.

    source
    string

    The ID of the Payment Instrument that will be debited and performing the Transfer.

    state
    string

    The stauts of the Transfer.

    Enum: "CANCELED" "PENDING" "FAILED" "SUCCEEDED" "UNKNOWN"
    statement_descriptor
    string or null
  • The description of the seller that appears on the buyer's bank or card statement.
  • statement_descriptors for `Transfers` in live enviroments will have a FI* prefix.
  • subtype
    string

    Additional information describing the payment_type.

    Enum: "API" "APPLICATION_FEE" "DISPUTE" "MERCHANT_CREDIT" "MERCHANT_CREDIT_ADJUSTMENT" "MERCHANT_DEBIT" "MERCHANT_DEBIT_ADJUSTMENT" "PLATFORM_CREDIT" "PLATFORM_CREDIT_ADJUSTMENT" "PLATFORM_DEBIT" "PLATFORM_DEBIT_ADJUSTMENT" "PLATFORM_FEE" "SETTLEMENT_MERCHANT" "SETTLEMENT_NOOP" "SETTLEMENT_PARTNER" "SETTLEMENT_PLATFORM" "SPLIT_PAYOUT" "SPLIT_PAYOUT_ADJUSTMENT" "SYSTEM"
    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    trace_id
    string or null

    Trace ID of the Transfer. The processor sends back the trace_id so you can track the Transfer end-to-end.

    type
    string

    Type of Transfer.

    Enum: "DEBIT" "CREDIT" "REVERSAL" "FEE" "ADJUSTMENT" "DISPUTE" "RESERVE" "SETTLEMENT" "UNKNOWN"
    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    401

    Authentication information is missing or invalid

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    get/transfers/{transfer_id}
    Request samples
    curl https://finix.sandbox-payments-api.com/transfers/TRvypRNBeqM597Zi4DcqJ2Vh \
      -H "Content-Type: application/vnd.json+api" \
      -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
    
    Response samples
    application/hal+json
    {}

    Update a Transfer

    Update a Transfer.

    Request
    path Parameters
    transfer_id
    required
    string

    ID of Transfer resource.

    Request Body schema: application/hal+json
    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    Responses
    200

    Single Transfer object

    Response Schema: application/hal+json
    id
    string

    The ID of the Transfer resource.

    created_at
    string <date-time>

    Timestamp of when the object was created.

    updated_at
    string <date-time>

    Timestamp of when the object was last updated.

    object or null

    Object detailing any Buyer Charges that got included in the Authorization.

    object

    Optional object detailing specific healthcare amounts.

    amount
    integer <int64>

    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

    application
    string

    The ID of the Application the Transfer was created under.

    object or null

    Details needed to process card present transactions.

    currency
    string

    ISO 4217 3 letter currency code.

    Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XXX" "YER" "ZAR" "ZMW" "ZWL"
    destination
    string or null

    The ID of the destination.

    device
    string

    The ID of the Device resource the Transfer was created under.

    externally_funded
    string

    Details if the Transfer will be settled externally by card processors.

    failure_code
    string or null

    The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see Failure Codes.

    failure_message
    string or null

    A human-readable description of why the transaction was declined. This will also include a suggestion on how to complete the payment.

    fee
    integer <int64>

    The amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the amount).

    fee_type
    string

    The type of fee.

    Enum: "APPLICATION_FEE" "ACH_BASIS_POINTS" "ACH_FIXED" "CARD_BASIS_POINTS" "CARD_FIXED" "CARD_INTERCHANGE" "VISA_BASIS_POINTS" "VISA_FIXED" "VISA_INTERCHANGE" "VISA_ASSESSMENT_BASIS_POINTS" "VISA_ACQUIRER_PROCESSING_FIXED" "VISA_CREDIT_VOUCHER_FIXED" "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED" "VISA_BASE_II_CREDIT_VOUCHER_FIXED" "VISA_KILOBYTE_ACCESS_FIXED" "DISCOVER_BASIS_POINTS" "DISCOVER_FIXED" "DISCOVER_INTERCHANGE" "DISCOVER_ASSESSMENT_BASIS_POINTS" "DISCOVER_DATA_USAGE_FIXED" "DISCOVER_NETWORK_AUTHORIZATION_FIXED" "DINERS_CLUB_BASIS_POINTS" "DINERS_CLUB_FIXED" "DINERS_CLUB_INTERCHANGE" "MASTERCARD_BASIS_POINTS" "MASTERCARD_FIXED" "MASTERCARD_INTERCHANGE" "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS" "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS" "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS" "JCB_BASIS_POINTS" "JCB_FIXED" "JCB_INTERCHANGE" "AMERICAN_EXPRESS_BASIS_POINTS" "AMERICAN_EXPRESS_FIXED" "AMERICAN_EXPRESS_INTERCHANGE" "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS" "DISPUTE_INQUIRY_FIXED_FEE" "DISPUTE_FIXED_FEE" "QUALIFIED_TIER_BASIS_POINTS_FEE" "QUALIFIED_TIER_FIXED_FEE" "CUSTOM" "ACH_DEBIT_RETURN_FIXED_FEE" "ACH_CREDIT_RETURN_FIXED_FEE" "ANCILLARY_FIXED_FEE_PRIMARY" "ANCILLARY_FIXED_FEE_SECONDARY" "SETTLEMENT_V2_TRANSFER"
    hsa_fsa_payment
    boolean or null

    Set to to true to process a payment using a Payment Instrument created from a health savings account (HSA) or flexible spending account (FSA).

    idempotency_id
    string or null

    ID to idempotently identifty the transfer.

    merchant_identity
    string

    The ID of the Merchant the Authorization was created under.

    messages
    Array of strings

    Message field that provides additional details. This field is typically null.

    (Raw (object or null)) or (Raw (string or null))

    Raw response from the processor.

    ready_to_settle_at
    string or null <date-time>

    Timestamp of when the Transfer is ready to be settled at.

    source
    string

    The ID of the Payment Instrument that will be debited and performing the Transfer.

    state
    string

    The stauts of the Transfer.

    Enum: "CANCELED" "PENDING" "FAILED" "SUCCEEDED" "UNKNOWN"
    statement_descriptor
    string or null
  • The description of the seller that appears on the buyer's bank or card statement.
  • statement_descriptors for `Transfers` in live enviroments will have a FI* prefix.
  • subtype
    string

    Additional information describing the payment_type.

    Enum: "API" "APPLICATION_FEE" "DISPUTE" "MERCHANT_CREDIT" "MERCHANT_CREDIT_ADJUSTMENT" "MERCHANT_DEBIT" "MERCHANT_DEBIT_ADJUSTMENT" "PLATFORM_CREDIT" "PLATFORM_CREDIT_ADJUSTMENT" "PLATFORM_DEBIT" "PLATFORM_DEBIT_ADJUSTMENT" "PLATFORM_FEE" "SETTLEMENT_MERCHANT" "SETTLEMENT_NOOP" "SETTLEMENT_PARTNER" "SETTLEMENT_PLATFORM" "SPLIT_PAYOUT" "SPLIT_PAYOUT_ADJUSTMENT" "SYSTEM"
    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    trace_id
    string or null

    Trace ID of the Transfer. The processor sends back the trace_id so you can track the Transfer end-to-end.

    type
    string

    Type of Transfer.

    Enum: "DEBIT" "CREDIT" "REVERSAL" "FEE" "ADJUSTMENT" "DISPUTE" "RESERVE" "SETTLEMENT" "UNKNOWN"
    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    401

    Authentication information is missing or invalid

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    put/transfers/{transfer_id}
    Request samples
    Response samples
    application/hal+json
    {}

    Refund or Reverse a Transfer

    Reverse a transfer with a type of DEBIT. This reversal creates a new Transfer resource with a type of REVERSAL.

    Related Guides: Refunding Payments

    Request
    path Parameters
    transfer_id
    required
    string

    ID of Transfer object.

    Request Body schema: application/hal+json
    Any of:
    refund_amount
    integer

    The amount of the refund in cents. It must be equal to or less than the amount of the original Transfer.

    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    Responses
    201

    Single Transfer object

    Response Schema: application/hal+json
    id
    string

    The ID of the Transfer resource.

    created_at
    string <date-time>

    Timestamp of when the object was created.

    updated_at
    string <date-time>

    Timestamp of when the object was last updated.

    object or null

    Object detailing any Buyer Charges that got included in the Authorization.

    object

    Optional object detailing specific healthcare amounts.

    amount
    integer <int64>

    The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

    application
    string

    The ID of the Application the Transfer was created under.

    object or null

    Details needed to process card present transactions.

    currency
    string

    ISO 4217 3 letter currency code.

    Enum: "AED" "AFN" "ALL" "AMD" "ANG" "AOA" "ARS" "AUD" "AWG" "AZN" "BAM" "BBD" "BDT" "BGN" "BHD" "BIF" "BMD" "BND" "BOB" "BOV" "BRL" "BSD" "BTN" "BWP" "BYR" "BZD" "CAD" "CDF" "CHE" "CHF" "CHW" "CLF" "CLP" "CNY" "COP" "COU" "CRC" "CUC" "CUP" "CVE" "CZK" "DJF" "DKK" "DOP" "DZD" "EGP" "ERN" "ETB" "EUR" "FJD" "FKP" "GBP" "GEL" "GHS" "GIP" "GMD" "GNF" "GTQ" "GYD" "HKD" "HNL" "HRK" "HTG" "HUF" "IDR" "ILS" "INR" "IQD" "IRR" "ISK" "JMD" "JOD" "JPY" "KES" "KGS" "KHR" "KMF" "KPW" "KRW" "KWD" "KYD" "KZT" "LAK" "LBP" "LKR" "LRD" "LSL" "LTL" "LYD" "MAD" "MDL" "MGA" "MKD" "MMK" "MNT" "MOP" "MRO" "MUR" "MVR" "MWK" "MXN" "MXV" "MYR" "MZN" "NAD" "NGN" "NIO" "NOK" "NPR" "NZD" "OMR" "PAB" "PEN" "PGK" "PHP" "PKR" "PLN" "PYG" "QAR" "RON" "RSD" "RUB" "RWF" "SAR" "SBD" "SCR" "SDG" "SEK" "SGD" "SHP" "SLL" "SOS" "SRD" "SSP" "STD" "SVC" "SYP" "SZL" "THB" "TJS" "TMT" "TND" "TOP" "TRY" "TTD" "TWD" "TZS" "UAH" "UGX" "USD" "USN" "UYI" "UYU" "UZS" "VEF" "VND" "VUV" "WST" "XAF" "XAG" "XAU" "XBA" "XBB" "XBC" "XBD" "XCD" "XDR" "XOF" "XPD" "XPF" "XPT" "XSU" "XTS" "XUA" "XXX" "YER" "ZAR" "ZMW" "ZWL"
    destination
    string or null

    The ID of the destination.

    device
    string

    The ID of the Device resource the Transfer was created under.

    externally_funded
    string

    Details if the Transfer will be settled externally by card processors.

    failure_code
    string or null

    The code of the failure so the decline can be handled programmatically. For more info on how to handle the failure, see Failure Codes.

    failure_message
    string or null

    A human-readable description of why the transaction was declined. This will also include a suggestion on how to complete the payment.

    fee
    integer <int64>

    The amount of the Transfer you'd like to collect as your fee in cents. Defaults to zero (must be less than or equal to the amount).

    fee_type
    string

    The type of fee.

    Enum: "APPLICATION_FEE" "ACH_BASIS_POINTS" "ACH_FIXED" "CARD_BASIS_POINTS" "CARD_FIXED" "CARD_INTERCHANGE" "VISA_BASIS_POINTS" "VISA_FIXED" "VISA_INTERCHANGE" "VISA_ASSESSMENT_BASIS_POINTS" "VISA_ACQUIRER_PROCESSING_FIXED" "VISA_CREDIT_VOUCHER_FIXED" "VISA_BASE_II_SYSTEM_FILE_TRANSMISSION_FIXED" "VISA_BASE_II_CREDIT_VOUCHER_FIXED" "VISA_KILOBYTE_ACCESS_FIXED" "DISCOVER_BASIS_POINTS" "DISCOVER_FIXED" "DISCOVER_INTERCHANGE" "DISCOVER_ASSESSMENT_BASIS_POINTS" "DISCOVER_DATA_USAGE_FIXED" "DISCOVER_NETWORK_AUTHORIZATION_FIXED" "DINERS_CLUB_BASIS_POINTS" "DINERS_CLUB_FIXED" "DINERS_CLUB_INTERCHANGE" "MASTERCARD_BASIS_POINTS" "MASTERCARD_FIXED" "MASTERCARD_INTERCHANGE" "MASTERCARD_ASSESSMENT_UNDER_1K_BASIS_POINTS" "MASTERCARD_ASSESSMENT_OVER_1K_BASIS_POINTS" "MASTERCARD_ACQUIRER_FEE_BASIS_POINTS" "JCB_BASIS_POINTS" "JCB_FIXED" "JCB_INTERCHANGE" "AMERICAN_EXPRESS_BASIS_POINTS" "AMERICAN_EXPRESS_FIXED" "AMERICAN_EXPRESS_INTERCHANGE" "AMERICAN_EXPRESS_ASSESSMENT_BASIS_POINTS" "DISPUTE_INQUIRY_FIXED_FEE" "DISPUTE_FIXED_FEE" "QUALIFIED_TIER_BASIS_POINTS_FEE" "QUALIFIED_TIER_FIXED_FEE" "CUSTOM" "ACH_DEBIT_RETURN_FIXED_FEE" "ACH_CREDIT_RETURN_FIXED_FEE" "ANCILLARY_FIXED_FEE_PRIMARY" "ANCILLARY_FIXED_FEE_SECONDARY" "SETTLEMENT_V2_TRANSFER"
    hsa_fsa_payment
    boolean or null

    Set to to true to process a payment using a Payment Instrument created from a health savings account (HSA) or flexible spending account (FSA).

    idempotency_id
    string or null

    ID to idempotently identifty the transfer.

    merchant_identity
    string

    The ID of the Merchant the Authorization was created under.

    messages
    Array of strings

    Message field that provides additional details. This field is typically null.

    (Raw (object or null)) or (Raw (string or null))

    Raw response from the processor.

    ready_to_settle_at
    string or null <date-time>

    Timestamp of when the Transfer is ready to be settled at.

    source
    string

    The ID of the Payment Instrument that will be debited and performing the Transfer.

    state
    string

    The stauts of the Transfer.

    Enum: "CANCELED" "PENDING" "FAILED" "SUCCEEDED" "UNKNOWN"
    statement_descriptor
    string or null
  • The description of the seller that appears on the buyer's bank or card statement.
  • statement_descriptors for `Transfers` in live enviroments will have a FI* prefix.
  • subtype
    string

    Additional information describing the payment_type.

    Enum: "API" "APPLICATION_FEE" "DISPUTE" "MERCHANT_CREDIT" "MERCHANT_CREDIT_ADJUSTMENT" "MERCHANT_DEBIT" "MERCHANT_DEBIT_ADJUSTMENT" "PLATFORM_CREDIT" "PLATFORM_CREDIT_ADJUSTMENT" "PLATFORM_DEBIT" "PLATFORM_DEBIT_ADJUSTMENT" "PLATFORM_FEE" "SETTLEMENT_MERCHANT" "SETTLEMENT_NOOP" "SETTLEMENT_PARTNER" "SETTLEMENT_PLATFORM" "SPLIT_PAYOUT" "SPLIT_PAYOUT_ADJUSTMENT" "SYSTEM"
    object

    Key value pair for annotating custom meta data (e.g. order numbers).

    trace_id
    string or null

    Trace ID of the Transfer. The processor sends back the trace_id so you can track the Transfer end-to-end.

    type
    string

    Type of Transfer.

    Enum: "DEBIT" "CREDIT" "REVERSAL" "FEE" "ADJUSTMENT" "DISPUTE" "RESERVE" "SETTLEMENT" "UNKNOWN"
    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    400

    Error

    401

    Authentication information is missing or invalid

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    422

    Error

    post/transfers/{transfer_id}/reversals
    Request samples
    Response samples
    application/hal+json
    {}

    List Reversals on a Transfer

    Retrieve a list of reversals for a Transfer.

    Request
    path Parameters
    transfer_id
    required
    string

    ID of Transfer object.

    query Parameters
    limit
    integer <int64>

    The number of entries to return.

    after_cursor
    string

    Return every resource created after the cursor value.

    before_cursor
    string

    Return every resource created before the cursor value.

    Responses
    200

    List of Reversals

    Response Schema: application/hal+json
    object

    Details the page that's returned.

    object

    List of Transfer objects.

    object

    For your convenience, every response includes several URLs which link to resources relevant to the request. You can use these _links to make your follow-up requests and quickly access relevant IDs.

    401

    Authentication information is missing or invalid

    403

    Forbidden

    404

    Object does not exist

    406

    Not Acceptable

    get/transfers/{transfer_id}/reversals
    Request samples
    curl https://finix.sandbox-payments-api.com/transfers/TRacB6Q6GcW6yvFUKawSnMEP/reversals \
      -H "Content-Type: application/vnd.json+api" \
      -u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
    
    Response samples
    application/hal+json
    {}