Skip to main content

V1PaymentsBody

Properties

NameTypeRequiredDescription
amountfloatThe amount received by the recipient, in units of the currency defined in currency. Decimal, including the correct number of decimal places for the currency exponent, as defined in ISO 2417:2015. To verify a card, set to 0.
currencystr
addressAddressaddress associated with this specific Rapyd entity Payment/Customer etc...
captureboolDetermines when the payment is processed for capture. When true, the payment is captured immediately. When false, the payment is captured at a later time. Relevant to cards. Default is true.
client_detailsClientDetailsObjectDescribes the fields in the client_details object in REST messages for payments. The client_details object describes the browser that the customer is using. The client collects this information and sends it as part of the Create Payment request. This information is used for processing the 3DS version 2 authentication of the customer. Note that Client Details information is not returned in the API response and it does not appear in any webhooks.
complete_payment_urlstrURL where the customer is redirected after successfully completing an operation on an external page.
customerstrstring - ID of the customer who is making the payment. String starting with cus_. Required if payment_method is blank. object - Contains all required fields
descriptionstrDescription of the payment
error_payment_urlstrURL where the customer is redirected in case of an error in the operation. Provided by the client.Relevant to bank redirect payment methods
escrowboolDetermines whether the payment is held in escrow for later release.
escrow_release_daysintDetermines the number of days after creation of the payment that funds are released from escrow. Funds are released at 5:00 pm GMT on the day indicated. Integer, range between 1-90. Default is 90.
ewalletstrID of the wallet that the money is paid into. String starting with ewallet_. Relevant when the request includes a single wallet.
ewalletsanyRepresents the wallets that the money is paid into. Array of objects.
expirationfloatEnd of the time allowed for customer to make this payment, in Unix time. Must be after the current time
fixed_sidestrIndicates whether the FX rate is fixed for the buy side (seller's Rapyd Wallet) or for the sell side (buyer).
group_paymentstrID of the group payment, a string starting with 'gp_'. Relevant to replacing a payment that failed.
initiation_typeInitiationTypeDescribes how the transaction was initiated.
merchant_reference_idstrID defined by the client. Limited to 255 characters.
metadatadictA JSON object defined by the client.
payment_feesFee
payment_methodV1PaymentsBodyPaymentMethodPayment Method object or ID.
payment_method_optionsdictObject describing additional information required for the payment. The object is returned by Get Payment Method Required Fields. Note that Transactions with 3DS authentication must be authenticated within 15 minutes, after which the possibility to authenticate expires.
receipt_emailstrEmail address that the receipt for this transaction is sent to.
requested_currencystrWhen fixed_side is sell, it is the currency received in the Rapyd Wallet. . When fixed_side is buy, it is the currency charged to the buyer (customer). Three-letter ISO 4217 code.
statement_descriptorstrA text description that appears in the customer's bank statement.

InitiationType

Describes how the transaction was initiated.

Properties

NameTypeRequiredDescription
CUSTOMERPRESENTstr"customer_present"
INSTALLMENTstr"installment"
MOTOstr"moto"
RECURRINGstr"recurring"
UNSCHEDULEDstr"unscheduled"

V1PaymentsBodyPaymentMethod

Payment Method object or ID.

Build Your Own SDKs with  liblab

Build developer friendly SDKs in minutes from your APIs

Start for Free →