PUT
/
v2.01
/
{ClientId}
/
recurringpayinregistrations
/
{RecurringPayinRegistrationId}
{
    "Status":"ENDED"
}  
{
    "Id": "recpayinreg_wt_c1fb7e3f-8204-4427-9251-df886fbb4e42",
    "Status": "ENDED",
    "ResultCode": null,
    "ResultMessage": null,
    "CurrentState": {
        "PayinsLinked": 2,
        "CumulatedDebitedAmount": {
            "Currency": "EUR",
            "Amount": 14500
        },
        "CumulatedFeesAmount": {
            "Currency": "EUR",
            "Amount": 1000
        },
        "LastPayinId": "wt_70621ad8-4ea8-4ea5-9893-b4b5ebb1da17"
    },
    "RecurringType": "CUSTOM",
    "TotalAmount": null,
    "CycleNumber": null,
    "AuthorId": "user_m_01J9KR16BG7EDC8RNEY2M18EXK",
    "CardId": null,
    "CreditedUserId": null,
    "CreditedWalletId": "wlt_m_01J9KR4A7BH8KVE4PG6DTNS817",
    "Billing": {
        "FirstName": "Ofelia",
        "LastName": "Kilback",
        "Address": {
            "AddressLine1": "8151 Sipes Turnpike",
            "AddressLine2": "Garfield Meadows",
            "City": "Paris",
            "Region": "Île-de-France",
            "PostalCode": "75001",
            "Country": "FR"
        }
    },
    "Shipping": {
        "FirstName": "Alex",
        "LastName": "Smith",
        "Address": {
            "AddressLine1": "6 rue de la Cité",
            "AddressLine2": "Appartement 3",
            "City": "Paris",
            "Region": "île-de-france",
            "PostalCode": "75003",
            "Country": "FR"
        }
    },
    "EndDate": null,
    "Frequency": null,
    "FixedNextAmount": false,
    "FractionedPayment": false,
    "FreeCycles": 0,
    "FirstTransactionDebitedFunds": {
        "Currency": "EUR",
        "Amount": 10000
    },
    "FirstTransactionFees": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "NextTransactionDebitedFunds": null,
    "NextTransactionFees": null,
    "Migration": false,
    "PaymentType": "PAYPAL"
}
This call can be used to change the following parameters:
  • Status – To manually close the recurring pay-in registration with the ENDED status. When doing so, no recurring pay-in can be created based on the registration anymore. Note that for PayPal, only one recurring registration can be used per UserId, so you may need to set the registration to ENDED in order to create a new one with the same user.
  • Billing and Shipping – To change information about billing and shipping.

Path parameters

RecurringPayinRegistrationId
string
required
The unique identifier of the recurring pay-in registration.

Body parameters

Status
string
Allowed values: ENDEDThe status of the recurring registration for PayPal:
  • CREATED – The recurring registration was created, but no recurring pay-in has yet been made.
  • AUTHENTICATION_NEEDED – A customer-initiated transaction (CIT) has been initiated against the registration but not authenticated. Note that there is no re-authentication process with PayPal: this status is only returned after the CIT is initiated but not yet successful.
  • IN_PROGRESS – The CIT has was successful and subsequent merchant-initiated transactions (MIT) can be requested.
  • ENDED – The registration can no longer be modified nor reused. A new one can be created for the same user.
Shipping
object
Information about the end user’s shipping address.
Billing
object
Information about the end user’s billing address.

Responses

{
    "Id": "recpayinreg_wt_c1fb7e3f-8204-4427-9251-df886fbb4e42",
    "Status": "ENDED",
    "ResultCode": null,
    "ResultMessage": null,
    "CurrentState": {
        "PayinsLinked": 2,
        "CumulatedDebitedAmount": {
            "Currency": "EUR",
            "Amount": 14500
        },
        "CumulatedFeesAmount": {
            "Currency": "EUR",
            "Amount": 1000
        },
        "LastPayinId": "wt_70621ad8-4ea8-4ea5-9893-b4b5ebb1da17"
    },
    "RecurringType": "CUSTOM",
    "TotalAmount": null,
    "CycleNumber": null,
    "AuthorId": "user_m_01J9KR16BG7EDC8RNEY2M18EXK",
    "CardId": null,
    "CreditedUserId": null,
    "CreditedWalletId": "wlt_m_01J9KR4A7BH8KVE4PG6DTNS817",
    "Billing": {
        "FirstName": "Ofelia",
        "LastName": "Kilback",
        "Address": {
            "AddressLine1": "8151 Sipes Turnpike",
            "AddressLine2": "Garfield Meadows",
            "City": "Paris",
            "Region": "Île-de-France",
            "PostalCode": "75001",
            "Country": "FR"
        }
    },
    "Shipping": {
        "FirstName": "Alex",
        "LastName": "Smith",
        "Address": {
            "AddressLine1": "6 rue de la Cité",
            "AddressLine2": "Appartement 3",
            "City": "Paris",
            "Region": "île-de-france",
            "PostalCode": "75003",
            "Country": "FR"
        }
    },
    "EndDate": null,
    "Frequency": null,
    "FixedNextAmount": false,
    "FractionedPayment": false,
    "FreeCycles": 0,
    "FirstTransactionDebitedFunds": {
        "Currency": "EUR",
        "Amount": 10000
    },
    "FirstTransactionFees": {
        "Currency": "EUR",
        "Amount": 1000
    },
    "NextTransactionDebitedFunds": null,
    "NextTransactionFees": null,
    "Migration": false,
    "PaymentType": "PAYPAL"
}
{
    "Status":"ENDED"
}