FORMULA PAYMENTS API
number · double · requiredstring · requiredstring · requiredstring · enum · requiredstring | null · uristring · requiredinteger · int64 · requiredboolean · requiredstring · requiredstring · requiredstring · required
Incoming payment initialization
Initialize pay-in
POST
https://api.frmpay.com
/pay-in
Creates a new pay-in order.
Depending on the selected payment method, the payment_data field in the response
contains different structures:
P2P_CARD→ bank card details for manual transferH2H→ hosted payment page URL
Initialize pay-in › Request Body
amountPayment amount
Example: 500
currencyPayment currency
Example: EUR
external_order_idMerchant-side unique order ID
Example: 66a0e20c-cf87-4077-8e2e-46b487879aa9
methodPayment method
Enum values:
P2P_CARD
H2H
Example: P2P_CARD
callback_urlCallback URL for payment status updates
Example: https://merchant.example.com/callback?order_id=66a0e20c-cf87-4077-8e2e-46b487879aa9
Initialize pay-in › Responses
200
Pay-in initialized successfully
idInternal payment ID
Example: 7f2f6f0c-6ec7-4b65-8e59-2d7f1ce11111
required
Payment details object. Structure depends on the selected payment method.
ttlTime-to-live in seconds
Example: 1800
acceptedWhether the payment initialization was accepted
Example: true
failure_reasonMachine-readable failure reason
Example:
failure_descriptionHuman-readable failure description
Example:
trace_idTrace ID for debugging and support
Example: 8e7dbd1f7d0b4b2d9d8c91c0d2f11111