Paypal payments

The paypal payment object and its fields

PayPal payments can be created and associated with an order in a few steps:
Create a Paypal payment, passing a valid return_url and cancel_url
Get the approval_url from the response
Redirect the customer to the approval URL
Get the paypal_payer_id from the return url parameters
Update the PayPal payment with the payer ID
PayPal payments are one-time payment sources and cannot be saved in customer wallets.
The paypal payment object
A paypal payment object is returned as part of the response body of each successful create, list, retrieve, or update API call.
Field
Type
Description
type
string
paypal_payments
id
string
The paypal payment unique identifier
links.self
string
The paypal payment endpoint URL
attributes.return_url
string
The URL where the payer is redirected after they approve the payment.
attributes.cancel_url
string
The URL where the payer is redirected after they cancel the payment.
attributes.note_to_payer
string
A free-form field that you can use to send a note to the payer on PayPal.
attributes.paypal_payer_id
string
The id of the payer that PayPal passes in the return_url.
attributes.name
string
The PayPal payer id (if present)
attributes.paypal_id
string
The id of the PayPal payment object.
attributes.status
string
The PayPal payment status. One of 'created' (default) or 'approved'.
attributes.approval_url
string
The URL the customer should be redirected to approve the payment.
attributes.created_at
datetime
Time at which the resource was created.
attributes.updated_at
datetime
Time at which the resource was last updated.
attributes.reference
string
A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever.
attributes.reference_origin
string
Any identifier of the third party system that defines the reference code
attributes.metadata
object
Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format.
relationships.order
object
The order associated to the paypal payment, that is set as its payment source.
meta.mode
string
The resource environment (can be one of test or live)

Delete a payment method

Create a paypal payment

Last updated 2 months ago

Field	Type	Description
type	`string`	`paypal_payments`
id	`string`	The paypal payment unique identifier
links.self	`string`	The paypal payment endpoint URL
attributes.return_url	`string`	The URL where the payer is redirected after they approve the payment.
attributes.cancel_url	`string`	The URL where the payer is redirected after they cancel the payment.
attributes.note_to_payer	`string`	A free-form field that you can use to send a note to the payer on PayPal.
attributes.paypal_payer_id	`string`	The id of the payer that PayPal passes in the return_url.
attributes.name	`string`	The PayPal payer id (if present)
attributes.paypal_id	`string`	The id of the PayPal payment object.
attributes.status	`string`	The PayPal payment status. One of 'created' (default) or 'approved'.
attributes.approval_url	`string`	The URL the customer should be redirected to approve the payment.
attributes.created_at	`datetime`	Time at which the resource was created.
attributes.updated_at	`datetime`	Time at which the resource was last updated.
attributes.reference	`string`	A string that you can use to add any external identifier to the resource. This can be useful for integrating the resource to an external system, like an ERP, a marketing tool, a CRM, or whatever.
attributes.reference_origin	`string`	Any identifier of the third party system that defines the reference code
attributes.metadata	`object`	Set of key-value pairs that you can attach to the resource. This can be useful for storing additional information about the resource in a structured format.
relationships.order	`object`	The order associated to the paypal payment, that is set as its payment source.
meta.mode	`string`	The resource environment (can be one of `test` or `live`)