Payments

Continue taking payment after the initial attempt.

Changed on Oct 29, 2026

Submit additional data for payment sessions that require further action after using attempt-payment. Note that our SDKs handle this step automatically.

post/payment-sessions/continue-payment

Request

Base URL
https://sandbox-api.ryftpay.com/v1
URL
https://sandbox-api.ryftpay.com/v1/payment-sessions/continue-payment
Auth
API key in header Authorization

Headers

Accountstring

Example:ac_3fe8398f-8cdb-43a3-9be2-806c4f84c327

The linked accountId (use this when operating on payments related to a linked account)

Request body

clientSecretstring required

The client secret of the payment session.

Example request

{
  "clientSecret": "ps_01FCTS1XMKH9FF43CAFA4CXT3P_secret_b83f2653-06d7-44a9-a548-5825e8186004",
  "threeDs": {
    "fingerprint": "ewogICJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ICI4ZjAxNzdhNC0yY2VkLTQ4NjUtODViNy1iYWQ5YmZhMzk4ZDIiLAogICJ0aHJlZURTQ29tcEluZCI6IlkiCn0=",
    "appAuthentication": {
      "sdkAppId": "7f8a1b2c-3d4e-4f5a-9b6c-1d2e3f4a5b6c",
      "sdkEncData": "eyJhbGciOiJBMTI4S1ciLCJlbmMiOiJBMTI4Q0JDLUhTMjU2In0.encrypted-device-data",
      "sdkEphemeralPublicKey": "{\"kty\":\"EC\",\"crv\":\"P-256\",\"x\":\"abc...\",\"y\":\"def...\"}",
      "sdkMaxTimeoutInMinutes": 10,
      "sdkReferenceNumber": "3DS_LOA_SDK_RAVL_020100_00123",
      "sdkTransId": "d41f6200-0435-49ee-aa11-f366f0661c6f",
      "deviceRenderOptions": {
        "sdkInterface": "01",
        "sdkUiTypes": [
          "01",
          "02",
          "03"
        ]
      }
    },
    "challengeResult": "ewogICJ0aHJlZURTU2VydmVyVHJhbnNJRCI6ICJkNDFmNjIwMC0wNDM1LTQ5ZWUtYWExMS1mMzY2ZjA2NjFjNmYiLAogICJ0cmFuc1N0YXR1cyI6IlkiCn0="
  }
}

Response

Request ok, check the 'status' field to determine if the payment was successful. If status remains in PendingAction then further action is required before the payment can be authorized. Check the requiredAction field for the next step.

idstring

The unique identifier for the payment

amountinteger

The amount of the sale/purchase in minor digits

currencystring

The ISO currency code

customerEmailstring nullable

The email address of the customer

enabledPaymentMethodsstring[]

List of payment method types that can be used to complete payment for this PaymentSession. Card is the default and will allow all card schemes configured on your account (Visa, Mastercard etc.). Apple Pay & Google Pay are classified as Card types and will be displayed provided you have confogured them properly.

The most recent error when attempting to Pay.

Note that we may add further values without notice.

returnUrlstring

URL to send the customer back to after a redirection (e.g. 3DS). We will always append the paymentSessionId under query param ps.

createdTimestampinteger

The epoch timestamp (seconds) when the payment was created

lastUpdatedTimestampinteger

The epoch timestamp (seconds) when the payment was last updated

Example response

{
  "id": "ps_01FCTS1XMKH9FF43CAFA4CXT3P",
  "amount": 500,
  "currency": "GBP",
  "customerEmail": "example@mail.com",
  "paymentMethod": {
    "type": "Card",
    "tokenizedDetails": {
      "id": "pmt_01G0EYVFR02KBBVE2YWQ8AKMGJ",
      "stored": true
    },
    "card": {
      "scheme": "Mastercard",
      "last4": "4242",
      "binDetails": {
        "issuer": "Ryft Bank Ltd",
        "issuerCountry": "GB",
        "fundingType": "Debit",
        "productType": "Consumer"
      }
    },
    "wallet": {
      "type": "ApplePay"
    },
    "billingAddress": {
      "firstName": "Nathan",
      "lastName": "Jones",
      "lineOne": "123 Test Street",
      "lineTwo": "456 Lane",
      "city": "Manchester",
      "country": "GB",
      "postalCode": "SP4 7DE",
      "region": "NY"
    },
    "checks": {
      "avsResponseCode": "Y",
      "cvvResponseCode": "M"
    }
  },
  "status": "PendingPayment",
  "lastError": "insufficient_funds",
  "requiredAction": {
    "type": "Redirect",
    "url": "https://ryftpay.com/3ds-auth"
  },
  "shippingDetails": {
    "address": {
      "firstName": "Fox",
      "lastName": "Mulder",
      "lineOne": "Stonehenge",
      "postalCode": "SP4 7DE",
      "city": "Salisbury",
      "country": "GB"
    }
  },
  "returnUrl": "https://ryftpay.com/checkout?orderId=123&ps=ps_01FCTS1XMKH9FF43CAFA4CXT3P",
  "createdTimestamp": 1470989538,
  "lastUpdatedTimestamp": 1470989538
}

Changes

Oct 29, 2026d73b6f121d8a Revision changes
- warning
  added the new 3ds_authentication_not_supported enum value to the response property for the response status
- warning
  added the new authorisation_denied enum value to the response property for the response status
- warning
  added the new in_person_terminal_action_cancelled enum value to the response property for the response status
- warning
  added the new in_person_terminal_action_timeout enum value to the response property for the response status
- warning
  added the new in_person_terminal_busy enum value to the response property for the response status
- warning
  added the new in_person_terminal_not_available enum value to the response property for the response status
- warning
  added the new payment_cancelled enum value to the response property for the response status
- warning
  added the new recurring_series_terminated enum value to the response property for the response status

Operation history