Direct Pay

Prahsys provides several convenient ways to gather and manage customer credit card details securely (see Pay Portal and Pay Session). However, you may prefer to manage this information directly and provide payment details with each transaction request. Using Direct Pay is incredibly straightforward and gives you complete control over your application’s payment flow.

What is Direct Pay?

Direct Pay allows you to include card details directly in payment API requests, bypassing the need for pay sessions or tokens. While we recommend using Prahsys sessions and tokenization to avoid handling sensitive card information on your servers, Direct Pay gives you complete control over the payment flow when your application requires it. All you need to do is pass the card details directly in the request body under the payment.billing.card field. Doing so let’s you process a payment in a single API call.

Alternatives

Prahsys offers several ways to process payments without you ever needing to touch sensitive customer information. If you still want the control and flexibility that comes with using the API transactions but without collecting card details directly, then consider using Pay Session. Prahsys can collect the sensitive data via iframes in your front-end and store it securely. Then when you’re ready to make an API request via your back-end, you can just reference the session id without providing any card info directly. For repeat transactions, you can have Prahsys tokenize the card details which were used in a session. We’ll store the sensitive data and you only need to save the token (learn more about tokenization here). If you want a turn-key solution requiring the least amount of effort to implement, check out our Pay Portal Sessions.

Using Direct Pay

Direct Pay can be used with the Authorize, Capture, Pay, and Verify transactions (learn more about these transactions here). Card details are always used within the context of a payment’s billing information. You can provide this in the body of a transaction request or add it to a payment for later use. Billing information can be added to a payment directly via our Update or Create Payment endpoint, or in the context of a session through our Update Session endpoint.

You can also tokenize card details yourself by providing them directly to the tokenization api (instead of referencing a pay session). Tokenization is the only operation which will use card details outside the context of a specific payment (see example in the tokenization guide).

Billing

You can provide card info to the Prahsys API by including it under the "card" attribute of a "billing" object. For all requests besides tokenization, billing info is provided under the "payment" field of the request body.

payment: {
  billing: {
    card: {
      number: "4111111111111111",
      expiry: {
        month: "12",
        year: "25",
      },
      securityCode: "123",
    },
  },
}