Update Payment Date - Regional API GetNet

Update Subscription Payment Date

This endpoint allows merchants to update the recurring payment date of an active subscription. It modifies the day of the month on which future charges will be generated.

Usage Scenarios:
- Adjusting the charge schedule based on customer preferences.
- Aligning the subscription billing date with payroll or other payment cycles.
- Correcting an initial setup error regarding the charge date.

Notes:
- Only the day of the month can be updated using this endpoint (e.g., 1 to 28 or 31, depending on calendar constraints).
- The update affects all future billing cycles, starting from the next charge.
- If the new date has already passed in the current month, the change applies starting the next available billing cycle.
- Ensure the subscription is active before attempting this update. Inactive or canceled subscriptions cannot be modified.

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Path 参数

Header 参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Request made successfully

Bodyapplication/json

示例

{
    "seller_id": "28f4dc41-8499-4ead-9976-f2fa20a45fd1",
    "order_id": "string",
    "installment_start_date": "2019-08-24",
    "create_date": "2019-08-24T14:15:22.123Z",
    "end_date": "2019-08-24T14:15:22.123Z",
    "payment_date": 1,
    "next_scheduled_date": "2019-08-24T14:15:22.123Z",
    "subscription": {
        "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627",
        "payment_type": {
            "credit": {
                "number_installments": 0,
                "billing_address": {
                    "street": "Av. Brazil",
                    "number": "1000",
                    "complement": "Sala 1",
                    "district": "Sao Geraldo",
                    "city": "Porto Alegre",
                    "state": "RS",
                    "country": "Brazil",
                    "postal_code": "90230060"
                },
                "soft_descriptor": "string",
                "transaction_type": "FULL",
                "tokenization": {
                    "type": "UCAF",
                    "cryptogram": "string",
                    "eci": "string",
                    "requestor_id": "string"
                },
                "card": {
                    "brand": "Mastercard",
                    "bin": "string",
                    "expiration_month": "st",
                    "expiration_year": "st",
                    "cardholder_name": "string",
                    "card_id": "string"
                },
                "wallet": {
                    "type": "string",
                    "id": "string"
                }
            },
            "debit": {
                "seller_id": "28f4dc41-8499-4ead-9976-f2fa20a45fd1",
                "order_id": "string",
                "payment_id": "d43b87f9-9e28-4802-8eaa-6ee91a40ea71",
                "amount": 0,
                "currency": "string",
                "status": "pending",
                "payment_received_timestamp": "2019-08-24T14:15:22.123Z",
                "credit": {
                    "delayed": true,
                    "authorization_code": "string",
                    "authorization_timestamp": "2019-08-24T14:15:22.123Z",
                    "reason_code": "string",
                    "reason_message": "string",
                    "acquirer": "string",
                    "soft_descriptor": "string",
                    "brand": "Mastercard",
                    "terminal_nsu": "string",
                    "acquirer_transaction_id": "string",
                    "transaction_id": "string"
                },
                "debit": {
                    "delayed": true,
                    "authorization_code": "string",
                    "authorization_timestamp": "2019-08-24T14:15:22.123Z",
                    "reason_code": "string",
                    "reason_message": "string",
                    "acquirer": "string",
                    "soft_descriptor": "string",
                    "brand": "Mastercard",
                    "terminal_nsu": "string",
                    "acquirer_transaction_id": "string",
                    "transaction_id": "string"
                },
                "error": {
                    "status_code": 0,
                    "name": "string",
                    "message": "string",
                    "details": [
                        {
                            "acquirer_transaction_id": "string",
                            "description": "string",
                            "description_detail": "string",
                            "error_code": "string",
                            "payment_id": "string",
                            "status": "string",
                            "terminal_nsu": "string"
                        }
                    ]
                }
            }
        },
        "shippings": [
            {
                "first_name": "string",
                "last_name": "string",
                "email": "string",
                "phone_number": "string",
                "shipping_amount": 0,
                "address": {
                    "street": "Av. Brazil",
                    "number": "1000",
                    "complement": "Sala 1",
                    "district": "Sao Geraldo",
                    "city": "Porto Alegre",
                    "state": "RS",
                    "country": "Brazil",
                    "postal_code": "90230060"
                }
            }
        ]
    },
    "customer": {
        "customer_id": "string",
        "first_name": "string",
        "last_name": "string",
        "document_type": "CPF",
        "document_type_name": "string",
        "document_number": "string",
        "document_country": "string",
        "phone_number": "string",
        "celphone_number": "string",
        "email": "string",
        "status": "active"
    },
    "plan": {
        "seller_id": "6eb2412c-165a-41cd-b1d9-76c575d70a28",
        "plan_id": "51995e24-b1ae-4826-8e15-2a568a87abdd",
        "name": "Plano flex",
        "description": "Flex plan",
        "amount": 19990,
        "currency": "BRL",
        "payment_types": "credit_card",
        "sales_tax": 0,
        "product_type": "cash_carry",
        "create_date": "2017-04-19T16:30:30Z",
        "status": "active",
        "period": {
            "type": "yearly",
            "billing_cycle": 12,
            "specific_cycle_in_days": 1
        },
        "floating_data": [
            {
                "installment": 2,
                "amount": 19990
            }
        ]
    },
    "device": {
        "ip_address": "string",
        "device_id": "string"
    },
    "floating_data": [
        {
            "installment": 2,
            "new_amount": 19990,
            "new_scheduled_date": "2020-06-10",
            "original_scheduled_date": "2020-06-10",
            "original_amount": 19990
        }
    ],
    "status": "processing",
    "status_details": "string",
    "payment": {
        "seller_id": "28f4dc41-8499-4ead-9976-f2fa20a45fd1",
        "order_id": "string",
        "payment_id": "d43b87f9-9e28-4802-8eaa-6ee91a40ea71",
        "amount": 0,
        "currency": "string",
        "status": "pending",
        "payment_received_timestamp": "2019-08-24T14:15:22.123Z",
        "credit": {
            "delayed": true,
            "authorization_code": "string",
            "authorization_timestamp": "2019-08-24T14:15:22.123Z",
            "reason_code": "string",
            "reason_message": "string",
            "acquirer": "string",
            "soft_descriptor": "string",
            "brand": "Mastercard",
            "terminal_nsu": "string",
            "acquirer_transaction_id": "string",
            "transaction_id": "string"
        },
        "debit": {
            "delayed": true,
            "authorization_code": "string",
            "authorization_timestamp": "2019-08-24T14:15:22.123Z",
            "reason_code": "string",
            "reason_message": "string",
            "acquirer": "string",
            "soft_descriptor": "string",
            "brand": "Mastercard",
            "terminal_nsu": "string",
            "acquirer_transaction_id": "string",
            "transaction_id": "string"
        },
        "error": {
            "status_code": 0,
            "name": "string",
            "message": "string",
            "details": [
                {
                    "acquirer_transaction_id": "string",
                    "description": "string",
                    "description_detail": "string",
                    "error_code": "string",
                    "payment_id": "string",
                    "status": "string",
                    "terminal_nsu": "string"
                }
            ]
        }
    }
}

🟠400

🟠404

🟠422

🔴500