--- url: >- https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/tokenization/oneClickPayment/unbind/index.md description: >- The unbind interface is used to解除已绑定的支付卡, applicable when users no longer use a specific card for quick payments or need to change payment methods. This interface belongs to the tokenization module, and by providing necessary parameters such as token_id, it can securely cancel the association between the card and account, ensuring user information security while simplifying the management process. --- # Unbind Interface ```apidef endpoint: POST /v4/paymethod/unbind name: Unbind Interface summary: Cancel an APM agreement variant: APM tags: Tokenization, APM ``` The unbind interface is used to解除已绑定的支付卡, applicable when users no longer use a specific card for quick payments or need to change payment methods. This interface belongs to the tokenization module, and by providing necessary parameters such as token_id, it can securely cancel the association between the card and account, ensuring user information security while simplifying the management process. ## Request Parameters | Parameter | Type | Required | Description | |--------|------|------|------| | accId | string | M | Unique identifier for the store, which will appear in the response message after creation; inputting it means modifying the data | | clientId | string | M | PingPong Merchant ID | | signType | string | M | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document | | sign | string | M | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature | | version | string | M | Version number, currently fixed at 1.0, may be adjusted with changes to the interface in the future | | bizContent | string | M | Collection of request parameters, with no limit on maximum length. Except for common request parameters, all other request parameters must be passed within this parameter, format: JSON string | | └─ requestId | string | M | Unique Request Number | | └─ merchantUserId | string | M | Member ID, the user's member ID on the merchant website | | └─ token | string | M | Authorization Token | | └─ notificationUrl | string | M | Merchant notification address. URL recommendation: use a complete URL with a publicly reachable domain name. Standard web ports are recommended (HTTPS defaults to 443 and HTTP defaults to 80). Ensure the URL can reliably receive PingPongCheckout asynchronous notifications. | ### Request Example ```json { "accId": "2022102018024210348883", "bizContent": "{\"merchantUserId\":\"1260489643332523151\",\"requestId\":\"PMT-PJ9QZGNGMW1716801752174\",\"notificationUrl\":\"https://test-acquirerpay.pingpongx.com/qa/result.html\",\"token\":\"43abe73a602bedb797a89aa22b0364fd\"}", "clientId": "2022102018024210348", "sign": "7680BF5DD90EF3BA2FB11C63CCD79A10A5E24FA56B473BF7592BA426306F7749", "signType": "SHA256", "version": "1.0" } ``` ## Response Parameters | Parameter | Type | Description | |--------|------|------| | code | string | Result status code, see the appendix Status Code Table: /en/notes/appendix/successCodeList/ | | description | string | Result description | | sign | string | Signature; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document. All parameters participate in the signature | | signType | string | Supports MD5 , SHA256; for details, see the Signature Specification: /en/notes/guide/sign/ section of this document | | bizContent | string | Business response parameters | | └─ token | string | authorization token | | └─ merchantUserId | string | user id | | └─ status | string | status, INVALID | ### Response Example ```json { "bizContent": "{\"token\":\"2f8ce12358632f7174dcad9b4fc004c9\",\"merchantUserId\":\"126048964333251315123\",\"status\":\"INVALID\"}", "code": "001000", "description": "Successful request", "sign": "382DE1E1562980708FFA7547260D802CBD6FA6EC883797D102ADA37A58DCA5D9", "signType": "SHA256" } ```