Fund transfer type

With this additional field, you can send multiple types of payments to Checkout.com through a single merchant setup. For example, Account-to-Account and Person-to-Person.

Overview

Schemes require each payment to be accompanied by a Fund Transfer Type code, which indicates the type of payment a merchant is making. This is because differently levels of screening are applied to different types of payments.

For merchants who only send one type of payment, we can configure this in our settings. However, for merchants who are sending different types of payments (e.g,. a remittance company sending both Account-to-Account and Person-to-Person payments), we enable merchants to send a Fund Transfer Type code with each transaction, identifying the type of transaction.

The benefits of this are having a single entity set up within Checkout.com, with flexible payment type settings.

Dynamic Fund Transfer Type in the payment request

In order to specify the Fund Transfer Type in your Unified Payments API payment request, you can include an optional string field in the payment request called fund_transfer_type.

In the fund_transfer_type field, you'll need to include the two-letter code that applies to your payment. We will then map to the correct code for Visa and Mastercard payments.

The table below outlines the possible codes.

👍

If you don’t know which fund_transfer_type applies, please contact your Customer Support representative.

Request example

Here is an example of an Account-to-Account pay to card request.

{
  "destination": {
    "type": "card",
    "number": "4242424242424242",
    "expiry_month": 12,
    "expiry_year": 2025,
  },
  "amount": 100,
  "currency": "GBP",
  "fund_transfer_type": "AA"
}

Response example

Use the approved field to check whether or not the authorization was successful ("approved": true).

{
  "id": "pay_mbabizu24mvu3mela5njyhpit4",
  "action_id": "act_mbabizu24mvu3mela5njyhpit4",
  "amount": 100,
  "currency": "GBP",
  "approved": true,
  "status": "Authorized",
  "auth_code": "770687",
  "eci": "05",
  "scheme_id": "638284745624527",
  "response_code": "10000",
  "response_summary": "Approved",
  "risk": {
    "flagged": false
  },
  "source": {
    "id": "src_nwd3m4in3hkuddfpjsaevunhdy",
    "type": "card",
    "expiry_month": 12,
    "expiry_year": 2025,
    "scheme": "Visa",
    "last4": "4242",
    "fingerprint": "F31828E2BDABAE63EB694903825CDD36041CC6ED461440B81415895855502832",
    "bin": "424242",
    "card_type": "Credit",
    "card_category": "Consumer",
    "issuer": "JPMORGAN CHASE BANK NA",
    "issuer_country": "US",
    "product_id": "A",
    "product_type": "Visa Traditional",
    "avs_check": "S",
    "cvv_check": ""
  },
  "customer": {
    "id": "cus_udst2tfldj6upmye2reztkmm4i"
  },
  "processed_on": "2019-01-25T11:03:36Z",
  "reference": "ORD-5023-4E89",
  "_links": {
    "self": {
      "href": "https://api.sandbox.checkout.com/payments/pay_mbabizu24mvu3mela5njyhpit4"
    },
    "actions": {
      "href": "https://api.sandbox.checkout.com/payments/pay_mbabizu24mvu3mela5njyhpit4/actions"
    },
    "capture": {
      "href": "https://api.sandbox.checkout.com/payments/pay_mbabizu24mvu3mela5njyhpit4/captures"
    },
    "void": {
      "href": "https://api.sandbox.checkout.com/payments/pay_mbabizu24mvu3mela5njyhpit4/voids"
    }
  }
}

Can we help?

Thanks for using Checkout.com. If you need any help or support, then message our support team at [email protected].