POST
/
MoneyIn
/
authorize
curl --request POST \
  --url https://api-sandbox.payabli.com/api/MoneyIn/authorize \
  --header 'Content-Type: application/json' \
  --header 'requestToken: <api-key>' \
  --data '{
  "entryPoint": "f743aed24a",
  "ipaddress": "255.255.255.255",
  "paymentMethod": {
    "initiator": "payor",
    "cardHolder": "John Cassian",
    "cardzip": "12345",
    "cardcvv": "123",
    "cardexp": "02/25",
    "cardnumber": "4111111111111111",
    "method": "card"
  },
  "paymentDetails": {
    "totalAmount": 100,
    "serviceFee": 0
  },
  "customerData": {
    "customerId": 4440
  }
}'
{
  "responseText": "Success",
  "isSuccess": true,
  "pageIdentifier": null,
  "responseData": {
    "authCode": "123456",
    "referenceId": "227-d30f8a47ddaf4fa989016d21d088ae5b",
    "resultCode": 1,
    "resultText": "Approved",
    "avsResponseText": "No address or ZIP match only",
    "cvvResponseText": "CVV2/CVC2 no match",
    "customerId": 1409,
    "methodReferenceId": null
  }
}

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Headers

idempotencyKey
string

A unique ID you can include to prevent duplicating objects or transactions if a request is sent more than once. This key is not generated in Payabli, you must generate it yourself.

Query Parameters

forceCustomerCreation
boolean
default:
false

When true, the request creates a new customer record, regardless of whether customer identifiers match an existing customer.

Body

Model request body for Authorize Transaction.

entryPoint
string | null
required

The entrypoint identifier.

Maximum length: 50
paymentMethod
object
required

Object describing payment method to use for transaction.

accountId
string | null

Custom identifier for payment connector.

Maximum length: 250
customerData
object

Object describing the customer/payor. Which fields are required depends on the paypoint's custom identifier settings. See PayorData Object Model for a complete reference.

invoiceData
object
orderDescription
string | null

Text description of the transaction.

Maximum length: 250
orderId
string | null

Custom identifier for the transaction.

Maximum length: 250
paymentDetails
object

Details about the payment.

source
string | null

Custom identifier to indicate the transaction or request source.

Maximum length: 100
subdomain
string | null

Refers to the payment page identifier. If provided, then the transaction is linked to the payment page.

Maximum length: 50
subscriptionId
integer

Payabli identifier of the subscription associated with the transaction.

Response

200 - application/json

General response for certain moneyIn and moneyOut endpoints.

isSuccess
boolean

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

pageIdentifier
string | null

Auxiliary validation used internally by payment pages and components.

responseData
object | null

The object containing the response data.

responseText
string | null

Response text for operation: 'Success' or 'Declined'.