Get Тransfers

GET 
/v2/customers/:customerId/transfers

You can use this API to get the transfers for the given customer. It returns the last 10 transfers by default.

Request

Path Parameters

customerId stringrequired

Query Parameters

merchantRefNum string

Possible values: <= 255 characters

This is the merchant reference number created by the merchant and submitted as part of the request. It must be unique for each request and allows cross referencing objects from merchant system.

limit integer

Possible values: >= 1 and <= 50

Default value: 10

This is the requested number of records to return. Max = 50. Default = 10.

offset integer

Default value: 0

This is the requested starting position of the response entries, where 0 is the first record. Default = 0.

slipId string

Payment slip

Responses

200

OK

application/json

Schema

Schema

transfers object[]

meta

object

Contains paging information regarding the returned records, when response is paginated.

The input for paginated query contains two parameters:

• limit - This is the requested number of records to return. Defaults to 10 and maximum is 50.
• offset - This is the requested starting position of the response, where 0 is the first record. Default = 0.

Note! The total number of records is not returned, to prevent queries spanning on all records. If numberOfRecords<limit, this means no further pages are available. On request of offset beyond the last record, the returned numberOfRecords is 0.

The number of previous pages can be calculated by dividing offset to limit.

numberOfRecords integer

This is the number of records returned in the lookup. Always numberOfRecords is smaller than or equal to limit.

limit integer

This is the requested number of records to be returned per page.

offset integer

This is the requested starting position of the response, where 0 is the first record.

page integer

This is the page of records on which the lookup starts. The starting page is 1.

Example (from schema)

{
  "transfers": [
    {
      "amount": 1000,
      "currencyCode": "EUR",
      "recipient": {
        "customerId": "string",
        "email": "user@example.com"
      },
      "merchantRefNum": "5040452805",
      "fxQuote": "string",
      "transferDetails": {
        "reason": "INITIAL_BALANCE_MIGRATION",
        "description": "string"
      },
      "id": "12356",
      "fees": [
        {
          "amount": 1000,
          "currency": "EUR",
          "paymentReason": "OTHER_FEE"
        }
      ],
      "creationTime": "2021-07-15T17:54:12Z",
      "expirationTime": "2021-07-15T17:54:12Z",
      "status": "COMPLETED",
      "statusReason": "string",
      "sender": {
        "customerId": "string",
        "accountId": "string"
      },
      "slipId": "string",
      "fxAmount": {
        "amount": 0,
        "rate": 0,
        "currency": "EUR"
      },
      "nextStatus": [
        "COMPLETED"
      ],
      "action": "NONE",
      "scaDetails": {
        "eventId": "06bdcd2c-0cce-4b36-97ec-281c8f5d743c",
        "walletOperationId": "a5865fd6-18c2-45a8-9953-1c00eac36c36",
        "authenticationMode": "OUTSOURCED",
        "availableVerifications": [
          {
            "method": "OTP",
            "channel": "SMS",
            "target": "jo***@example.com"
          }
        ],
        "creationTime": "2021-07-15T17:54:12Z",
        "expirationTime": "2021-07-15T17:54:12Z"
      }
    }
  ],
  "meta": {
    "numberOfRecords": 1,
    "limit": 10,
    "offset": 0,
    "page": 1
  }
}

GET_LOCAL_EXCHANGE

{
  "transfers": [
    {
      "amount": 1000,
      "currencyCode": "GBP",
      "recipient": {
        "customerId": "5435323362",
        "email": "user@example.com"
      },
      "fxQuote": "404679be-ccbf-4528-b880-e14cc5041753",
      "transferDetails": {
        "reason": "CURRENCY_EXCHANGE",
        "description": "Exchange money"
      },
      "id": "12356",
      "fee": 100,
      "fees": [
        {
          "amount": 100,
          "currency": "GBP",
          "paymentReason": "MERCHANT_FEE"
        }
      ],
      "creationTime": "2021-07-15T17:54:12Z",
      "expirationTime": "2021-07-15T17:54:12Z",
      "status": "COMPLETED",
      "slipId": "5009964049",
      "fxAmount": {
        "amount": 1035,
        "rate": 1.15,
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "numberOfRecords": 1,
    "limit": 1,
    "page": 1
  }
}

GET_TRANSFER

{
  "transfers": [
    {
      "amount": 1000,
      "currencyCode": "EUR",
      "recipient": {
        "customerId": "5435323363",
        "email": "user@example.com"
      },
      "merchantRefNum": "5040452805",
      "transferDetails": {
        "reason": "PEER_TRANSFER",
        "description": "Transfer to friend."
      },
      "id": "12356",
      "fee": 100,
      "fees": [
        {
          "amount": 100,
          "currency": "EUR",
          "paymentReason": "MERCHANT_FEE"
        }
      ],
      "creationTime": "2021-07-15T17:54:12Z",
      "expirationTime": "2021-07-15T17:54:12Z",
      "status": "COMPLETED",
      "slipId": "5009964049"
    }
  ],
  "meta": {
    "numberOfRecords": 1,
    "limit": 1,
    "page": 1
  }
}

Loading...