Transfer Attempts

A transfer_attempt is created when a buyer attempts to pay for a payment using a Payment Link or Checkout Form. Using Transfer Attempts, you can track the lifecycle of a payment or a series of payments if you are using a multi-use Payment Link.

Each transfer_attempt has as reference to a transfer_id to allow you to query it for additional data.

List Transfer Attempts

Retrieve a list of all Transfer Attempt resources, or filter the results to a specific Checkout Form, Payment Link, and Payout Link using the entity_id query parameter.

For details on how to query endpoints using the available parameters, see Query Parameters.

Request
query Parameters
after_cursor
string

Return every resource created after the cursor value.

Example: after_cursor=TRnasXQ5AmjsLnPMwnme7TL4
before_cursor
string

Return every resource created before the cursor value.

Example: before_cursor=TRnasXQ5AmjsLnPMwnme7TL4
entity_id
string

Filter by the ID of the Checkout Form, Payment Link or Payout Link.

Example: entity_id=checkout_form_ciADaDNMFAHdyNbDPuByS
limit
integer

The numbers of items to return.

Example: limit=10
header Parameters
Finix-Version
string
Default: 2018-01-01

Specify the API version of your request. For more details, see Versioning.

Example: 2022-02-01
Responses
200

List of Transfer Attempt objects.

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

422

Invalid field

get/transfer_attempts
Request samples 
curl "https://finix.sandbox-payments-api.com/transfer_attempts" \
  -H "Finix-Version: 2022-02-01" \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda
Response samples
application/json
{
  • "_embedded": {
    • "transfer_attempts": [
      ]
    },
  • "_links": {},
  • "page": {
    • "limit": 100,
    • "next_cursor": "transfer_attempt_ciACBK59kDhfx2Mi4Vy81"
    }
}

Fetch a Transfer Attempt

Retrieve the details of a Transfer Attempt initiated from a Checkout Form, Payment Link or Payout Link.

Request
path Parameters
transfer_attempt_id
required
string

The ID of the Transfer Attempt.

header Parameters
Finix-Version
string
Default: 2018-01-01

Specify the API version of your request. For more details, see Versioning.

Example: 2022-02-01
Responses
200

A single Transfer Attempt object.

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

422

Invalid field

get/transfer_attempts/{transfer_attempt_id}
Request samples 
curl "https://finix.sandbox-payments-api.com/transfer_attempts/transfer_attempt_ciACBK59kDhfx2Mi4Vy81" \
  -H "Finix-Version: 2022-02-01" \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda
Response samples
application/json
{
  • "id": "transfer_attempt_ciADTi3MFTjJdrCuvoNZk",
  • "created_at": "2024-12-27T06:08:45.23Z",
  • "updated_at": "2024-12-27T06:08:45.23Z",
  • "amount": 5418,
  • "application_id": "APc9vhYcPsRuTSpKD9KpMtPe",
  • "buyer_details": {
    • "first_name": "John",
    • "last_name": "Smith",
    • "email": "johnsmith@gmail.com",
    • "identity_id": "IDkw7UhEWpBXpzSkwi3GtzeB",
    • "phone": null,
    • "billing_address": null,
    • "shipping_address": {
      }
    },
  • "currency": "USD",
  • "entity_id": "checkout_form_ciADaDNMFAHdyNbDPuByS",
  • "entity_type": "CHECKOUT_FORM",
  • "failure_code": null,
  • "failure_message": null,
  • "merchant_id": "MUmfEGv5bMpSJ9k5TFRUjkmm",
  • "operation_key": "SALE",
  • "payment_frequency": "ONE_TIME",
  • "payment_instrument_id": "PI7m5SAdXgkLYRDKmjiYfDgy",
  • "recipient_details": null,
  • "recipient_merchant_id": null,
  • "state": "SUCCEEDED",
  • "tags": { },
  • "transfer_id": "TRRM1Gf9q8iXB22yZNviNPZ",
  • "type": "DEBIT"
}